2 // System.Web.UI.WebControls.Literal.cs
5 // Jackson Harper (jackson@ximian.com)
7 // (C) 2005 Novell, Inc (http://www.novell.com)
9 // Permission is hereby granted, free of charge, to any person obtaining
10 // a copy of this software and associated documentation files (the
11 // "Software"), to deal in the Software without restriction, including
12 // without limitation the rights to use, copy, modify, merge, publish,
13 // distribute, sublicense, and/or sell copies of the Software, and to
14 // permit persons to whom the Software is furnished to do so, subject to
15 // the following conditions:
17 // The above copyright notice and this permission notice shall be
18 // included in all copies or substantial portions of the Software.
20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 using System.Collections;
30 using System.ComponentModel;
32 using System.Globalization;
33 using System.Collections.Specialized;
34 using System.Security.Permissions;
36 namespace System.Web.UI.WebControls {
39 [AspNetHostingPermissionAttribute (SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
40 [AspNetHostingPermissionAttribute (SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
42 [ValidationProperty("SelectedItem")]
44 [SupportsEventValidation]
46 public class ListBox : ListControl, IPostBackDataHandler {
53 #if NET_2_0 && HAVE_CONTROL_ADAPTERS
59 get { return base.BorderColor; }
60 set { base.BorderColor = value; }
64 #if NET_2_0 && HAVE_CONTROL_ADAPTERS
69 BorderStyle BorderStyle {
70 get { return base.BorderStyle; }
71 set { base.BorderStyle = value; }
75 #if NET_2_0 && HAVE_CONTROL_ADAPTERS
81 get { return base.BorderWidth; }
82 set { base.BorderWidth = value; }
89 [WebSysDescription ("")]
90 [WebCategory ("Appearance")]
91 public virtual int Rows {
93 return ViewState.GetInt ("Rows", 4);
96 if (value < 1 || value > 2000)
97 throw new ArgumentOutOfRangeException ("value");
98 ViewState ["Rows"] = value;
102 [DefaultValue(ListSelectionMode.Single)]
103 [WebSysDescription ("")]
104 [WebCategory ("Behavior")]
105 public virtual ListSelectionMode SelectionMode {
107 return (ListSelectionMode) ViewState.GetInt ("SelectionMode",
108 (int) ListSelectionMode.Single);
111 if (!Enum.IsDefined (typeof (ListSelectionMode), value))
112 throw new ArgumentOutOfRangeException ("value");
113 ViewState ["SelectionMode"] = value;
120 [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
121 [EditorBrowsable(EditorBrowsableState.Never)]
122 public override string ToolTip {
123 get { return String.Empty; }
124 set { /* Tooltip is always String.Empty */ }
129 public virtual int[] GetSelectedIndices ()
131 return (int []) GetSelectedIndicesInternal ().ToArray (typeof (int));
135 protected override void AddAttributesToRender (HtmlTextWriter writer)
138 Page.VerifyRenderingInServerForm (this);
140 base.AddAttributesToRender (writer);
143 writer.AddAttribute (HtmlTextWriterAttribute.Name, UniqueID);
145 writer.AddAttribute (HtmlTextWriterAttribute.Name, UniqueID);
150 writer.AddAttribute (HtmlTextWriterAttribute.Onchange, Page.ClientScript.GetPostBackEventReference (GetPostBackOptions (), true));
152 writer.AddAttribute (HtmlTextWriterAttribute.Onchange,
153 Page.ClientScript.GetPostBackClientHyperlink (this, ""));
156 if (SelectionMode == ListSelectionMode.Multiple)
157 writer.AddAttribute (HtmlTextWriterAttribute.Multiple,
159 writer.AddAttribute (HtmlTextWriterAttribute.Size,
160 Rows.ToString (CultureInfo.InvariantCulture));
164 PostBackOptions GetPostBackOptions () {
165 PostBackOptions options = new PostBackOptions (this);
166 options.ActionUrl = null;
167 options.ValidationGroup = null;
168 options.Argument = "";
169 options.RequiresJavaScriptProtocol = false;
170 options.ClientSubmit = true;
171 options.PerformValidation = CausesValidation && Page != null && Page.AreValidatorsUplevel (ValidationGroup);
172 if (options.PerformValidation)
173 options.ValidationGroup = ValidationGroup;
180 protected override void RenderContents (HtmlTextWriter writer)
182 foreach (ListItem item in Items) {
183 writer.WriteBeginTag ("option");
185 writer.WriteAttribute ("selected", "selected", false);
187 writer.WriteAttribute ("value", item.Value, true);
190 string encoded = HttpUtility.HtmlEncode (item.Text);
191 writer.Write (encoded);
192 writer.WriteEndTag ("option");
203 override void OnPreRender (EventArgs e)
205 base.OnPreRender (e);
206 if (Page != null && Enabled)
207 Page.RegisterRequiresPostBack (this);
213 bool LoadPostData (string postDataKey, NameValueCollection postCollection)
218 string [] values = postCollection.GetValues (postDataKey);
219 if (values == null || values.Length == 0) {
220 int prev_index = SelectedIndex;
222 return (prev_index != -1);
225 if (SelectionMode == ListSelectionMode.Single)
226 return SelectSingle (values);
227 return SelectMultiple (values);
230 bool SelectSingle (string [] values)
232 string val = values [0];
233 int idx = Items.IndexOf (val);
234 int prev_index = SelectedIndex;
235 if (idx != prev_index) {
236 // This will set both the index value and the item.Selected property
243 bool SelectMultiple (string [] values)
245 ArrayList prev_selected = GetSelectedIndicesInternal ();
247 foreach (string val in values) {
248 ListItem item = Items.FindByValue (val);
250 item.Selected = true;
253 ArrayList new_selection = GetSelectedIndicesInternal ();
254 int i = prev_selected.Count;
255 if (new_selection.Count != i)
259 if ((int) prev_selected [i] != (int) new_selection [i])
269 void RaisePostDataChangedEvent ()
272 if (CausesValidation)
273 Page.Validate (ValidationGroup);
275 OnSelectedIndexChanged (EventArgs.Empty);
278 bool IPostBackDataHandler.LoadPostData (string postDataKey,
279 NameValueCollection postCollection)
281 return LoadPostData (postDataKey, postCollection);
284 void IPostBackDataHandler.RaisePostDataChangedEvent ()
286 RaisePostDataChangedEvent ();
289 protected internal override void VerifyMultiSelect()
291 //by default the ListControl will throw an exception in this method,
292 //therefor we should override the method if the class is supporting
293 //MultiSelect option.
294 if (this.SelectionMode != ListSelectionMode.Multiple)
295 throw new HttpException("Multiple select option is not supported");