Files
mono/mcs/class/System.Web/System.Web.UI.WebControls/ListControl.cs
T
Gonzalo Paniagua Javier 24fdf865f0 2005-09-27 Gonzalo Paniagua Javier <[email protected]>
* ListControl.cs: SelectedIndex/SelectedValue can be set before
	DataBinding () is called on the control, so we have to keep this values
	around and use them after the data is read. If both properties are
	used, they must refer to the same item.


svn path=/trunk/mcs/; revision=50814
2005-09-27 05:04:25 +00:00

602 lines
14 KiB
C#

//
// System.Web.UI.WebControls.ListControl.cs
//
// Authors:
// Jackson Harper ([email protected])
//
// (C) 2005 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
using System;
using System.Drawing;
using System.Web.Util;
using System.Collections;
using System.Globalization;
using System.ComponentModel;
using System.Collections.Specialized;
namespace System.Web.UI.WebControls {
[DataBindingHandler("System.Web.UI.Design.WebControls.ListControlDataBindingHandler, " + Consts.AssemblySystem_Design)]
[DefaultEventAttribute ("SelectedIndexChanged")]
#if !NET_2_0
[DefaultPropertyAttribute ("DataSource")]
#endif
[Designer("System.Web.UI.Design.WebControls.ListControlDesigner, " + Consts.AssemblySystem_Design, "System.ComponentModel.Design.IDesigner")]
#if NET_2_0
[ControlValueProperty ("SelectedValue", null)]
[ParseChildrenAttribute (true, "Items", ChildControlType = typeof (Control))]
#else
[ParseChildrenAttribute (true, "Items")]
#endif
public abstract class ListControl :
#if NET_2_0
DataBoundControl, IEditableTextControl, ITextControl
#else
WebControl
#endif
{
private static readonly object SelectedIndexChangedEvent = new object ();
#if NET_2_0
private static readonly object TextChangedEvent = new object ();
#endif
private ListItemCollection items;
int saved_selected_index = -2;
string saved_selected_value;
public ListControl () : base (HtmlTextWriterTag.Select)
{
}
#if NET_2_0
[DefaultValue (false)]
[Themeable (false)]
[MonoTODO]
[WebSysDescription ("")]
[WebCategory ("Behavior")]
public virtual bool AppendDataBoundItems
{
get {
return ViewState.GetBool ("AppendDataBoundItems", false);
}
set {
ViewState ["AppendDataBoundItems"] = value;
}
}
#endif
#if NET_2_0
[Themeable (false)]
#endif
[DefaultValue(false)]
[WebSysDescription ("")]
[WebCategory ("Behavior")]
public virtual bool AutoPostBack {
get { return ViewState.GetBool ("AutoPostBack", false); }
set { ViewState ["AutoPostBack"] = value; }
}
#if ONLY_1_1
[DefaultValue("")]
[WebSysDescription ("")]
[WebCategory ("Data")]
public virtual string DataMember {
get { return ViewState.GetString ("DataMember", String.Empty); }
set { ViewState ["DataMember"] = value; }
}
private object data_source;
[Bindable(true)]
[DefaultValue(null)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[WebSysDescription ("")]
[WebCategory ("Data")]
public virtual object DataSource {
get { return data_source; }
set { data_source = value; }
}
#endif
#if NET_2_0
[Themeable (false)]
#endif
[DefaultValue("")]
[WebSysDescription ("")]
[WebCategory ("Data")]
public virtual string DataTextField {
get { return ViewState.GetString ("DataTextField", String.Empty); }
set { ViewState ["DataTextField"] = value; }
}
#if NET_2_0
[Themeable (false)]
#endif
[DefaultValue("")]
[WebSysDescription ("")]
[WebCategory ("Data")]
public virtual string DataTextFormatString {
get { return ViewState.GetString ("DataTextFormatString", String.Empty); }
set { ViewState ["DataTextFormatString"] = value; }
}
#if NET_2_0
[Themeable (false)]
#endif
[DefaultValue("")]
[WebSysDescription ("")]
[WebCategory ("Data")]
public virtual string DataValueField {
get { return ViewState.GetString ("DataValueField", String.Empty); }
set { ViewState ["DataValueField"] = value; }
}
#if NET_2_0
[Editor ("System.Web.UI.Design.WebControls.ListItemsCollectionEditor," + Consts.AssemblySystem_Design, "System.Drawing.Design.UITypeEditor, " + Consts.AssemblySystem_Drawing)]
#endif
[DefaultValue(null)]
[MergableProperty(false)]
[PersistenceMode(PersistenceMode.InnerDefaultProperty)]
[WebSysDescription ("")]
[WebCategory ("Misc")]
public virtual ListItemCollection Items {
get {
if (items == null)
items = new ListItemCollection ();
return items;
}
}
// I can't find this info stored in the viewstate anywhere
// so it must be calculated on the fly.
[Bindable(true)]
[Browsable(false)]
[DefaultValue(0)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
#if NET_2_0
[Themeable (false)]
#endif
[WebSysDescription ("")]
[WebCategory ("Misc")]
public virtual int SelectedIndex {
get {
if (items == null)
return -1;
for (int i = 0; i < items.Count; i++) {
if (items [i].Selected)
return i;
}
return -1;
}
set {
ClearSelection ();
if (value == -1)
return;
if (items == null || items.Count == 0) {
// This will happen when assigning this property
// before DataBind () is called on the control.
saved_selected_index = value;
return;
}
if (value < 0 || value >= Items.Count)
throw new ArgumentOutOfRangeException ("value");
items [value].Selected = true;
/* you'd think this would be called, but noooo */
//OnSelectedIndexChanged (EventArgs.Empty);
}
}
[Browsable(false)]
[DefaultValue(null)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[WebSysDescription ("")]
[WebCategory ("Misc")]
public virtual ListItem SelectedItem {
get {
int si = SelectedIndex;
if (si == -1)
return null;
return Items [si];
}
}
#if NET_2_0
[Bindable(true, BindingDirection.TwoWay)]
[Themeable (false)]
#else
[Bindable(true)]
#endif
[Browsable(false)]
[DefaultValue("")]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[WebSysDescription ("")]
[WebCategory ("Misc")]
public virtual string SelectedValue {
get {
int si = SelectedIndex;
if (si == -1)
return String.Empty;
return Items [si].Value;
}
set {
ClearSelection ();
if (items == null || items.Count == 0) {
// This will happen when assigning this property
// before DataBind () is called on the control.
saved_selected_value = value;
return;
}
int count = Items.Count;
ListItemCollection coll = Items;
for (int i = 0; i < count; i++) {
Console.WriteLine ("Target: {0} value: {1}", value, coll [i].Value);
if (coll [i].Value == value)
coll [i].Selected = true;
}
}
}
#if NET_2_0
[Themeable (false)]
[DefaultValue ("")]
[DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
[Browsable (false)]
[MonoTODO]
[WebSysDescription ("")]
[WebCategoryAttribute ("Behavior")]
public virtual string Text {
get {
return SelectedValue;
}
set {
SelectedValue = value;
/* you'd think this would be called, but noooo */
//OnTextChanged (EventArgs.Empty);
}
}
#if HAVE_CONTROL_ADAPTERS
protected virtual new
#else
protected override
#endif
HtmlTextWriterTag TagKey
{
get {
return HtmlTextWriterTag.Select;
}
}
protected override void AddAttributesToRender (HtmlTextWriter w)
{
base.AddAttributesToRender (w);
}
#endif
public virtual void ClearSelection ()
{
if (items == null)
return;
int count = Items.Count;
for (int i = 0; i<count; i++)
items [i].Selected = false;
}
#if NET_2_0
protected internal override void LoadControlState (object savedState)
{
object first = null;
ArrayList indices = null;
Pair pair = savedState as Pair;
if (pair != null) {
first = pair.First;
indices = pair.Second as ArrayList;
}
base.LoadControlState (first);
if (indices != null) {
foreach (int index in indices)
Items [index].Selected = true;
}
}
#endif
protected override void OnDataBinding (EventArgs e)
{
base.OnDataBinding (e);
IEnumerable list = DataSourceResolver.ResolveDataSource (DataSource, DataMember);
if (list == null)
return;
Items.Clear ();
string format = DataTextFormatString;
if (format == "")
format = null;
string text_field = DataTextField;
string value_field = DataValueField;
ListItemCollection coll = Items;
foreach (object container in list) {
string text;
string val;
if (text_field != "") {
text = DataBinder.GetPropertyValue (container, text_field, format);
} else {
text = "";
}
if (value_field != "") {
val = DataBinder.GetPropertyValue (container, value_field).ToString ();
} else if (text_field == "") {
text = val = container.ToString ();
if (format != null)
text = String.Format (format, container);
} else {
val = text;
}
coll.Add (new ListItem (text, val));
}
if (saved_selected_value != null) {
SelectedValue = saved_selected_value;
if (saved_selected_index != -2 && saved_selected_index != SelectedIndex)
throw new ArgumentException ("SelectedIndex and SelectedValue are mutually exclusive.");
} else if (saved_selected_index != -2) {
SelectedIndex = saved_selected_index;
// No need to check saved_selected_value here, as it's done before.
}
}
#if NET_2_0
protected internal override void OnInit (EventArgs e)
{
Page.RegisterRequiresControlState (this);
base.OnInit (e);
}
#endif
#if NET_2_0
protected internal
#else
protected
#endif
override void OnPreRender (EventArgs e)
{
base.OnPreRender (e);
}
#if NET_2_0
protected virtual void OnTextChanged (EventArgs e)
{
EventHandler handler = (EventHandler) Events [TextChangedEvent];
if (handler != null)
handler (this, e);
}
[MonoTODO]
protected internal override void PerformDataBinding (IEnumerable dataSource)
{
throw new NotImplementedException ();
}
[MonoTODO]
protected override void PerformSelect ()
{
throw new NotImplementedException ();
}
[MonoTODO]
protected internal override void RenderContents (HtmlTextWriter w)
{
base.RenderContents (w);
}
protected internal override object SaveControlState ()
{
object first;
ArrayList second;
first = base.SaveControlState ();
second = GetSelectedIndices();
if (second == null)
second = new ArrayList();
return new Pair (first, second);
}
#endif
ArrayList GetSelectedIndices ()
{
ArrayList selected = null;
if (items != null) {
selected = new ArrayList ();
int count = Items.Count;
for (int i = 0; i < count; i++) {
if (items [i].Selected)
selected.Add (i);
}
}
return selected;
}
protected override object SaveViewState ()
{
object first = null;
object second = null;
first = base.SaveViewState ();
IStateManager manager = items as IStateManager;
if (manager != null)
second = manager.SaveViewState ();
#if !NET_2_0
ArrayList selected = GetSelectedIndices ();
#endif
if (first == null && second == null
#if !NET_2_0
&& selected == null
#endif
)
return null;
#if NET_2_0
return new Pair (first, second);
#else
return new Triplet (first, second, selected);
#endif
}
protected override void LoadViewState (object savedState)
{
object first = null;
object second = null;
#if !NET_2_0
ArrayList indices = null;
#endif
#if NET_2_0
Pair pair = savedState as Pair;
if (pair != null) {
first = pair.First;
second = pair.Second;
}
#else
Triplet triplet = savedState as Triplet;
if (triplet != null) {
first = triplet.First;
second = triplet.Second;
indices = triplet.Third as ArrayList;
}
#endif
base.LoadViewState (first);
if (second != null) {
IStateManager manager = Items as IStateManager;
manager.LoadViewState (second);
}
#if !NET_2_0
if (indices != null) {
foreach (int index in indices)
Items [index].Selected = true;
}
#endif
}
#if NET_2_0
[MonoTODO]
protected void SetPostDataSelection (int selectedIndex)
{
throw new NotImplementedException ();
}
#endif
protected override void TrackViewState ()
{
base.TrackViewState ();
IStateManager manager = items as IStateManager;
if (manager != null)
manager.TrackViewState ();
}
protected virtual void OnSelectedIndexChanged (EventArgs e)
{
EventHandler handler = (EventHandler) Events [SelectedIndexChangedEvent];
if (handler != null)
handler (this, e);
}
#if NET_2_0
protected internal virtual void VerifyMultiSelect ()
{
}
#endif
[WebSysDescription ("")]
[WebCategory ("Action")]
public event EventHandler SelectedIndexChanged {
add { Events.AddHandler (SelectedIndexChangedEvent, value); }
remove { Events.RemoveHandler (SelectedIndexChangedEvent, value); }
}
#if NET_2_0
/* sealed in the docs */
public event EventHandler TextChanged {
add {
Events.AddHandler (TextChangedEvent, value);
}
remove {
Events.RemoveHandler (TextChangedEvent, value);
}
}
[MonoTODO]
[Themeable (false)]
[DefaultValue (false)]
[WebSysDescription ("")]
[WebCategory ("Behavior")]
public virtual bool CausesValidation {
get {
throw new NotImplementedException ();
}
set {
throw new NotImplementedException ();
}
}
[MonoTODO]
[Themeable (false)]
[DefaultValue ("")]
[WebSysDescription ("")]
[WebCategoryAttribute ("Behavior")]
public virtual string ValidationGroup {
get {
throw new NotImplementedException ();
}
set {
throw new NotImplementedException ();
}
}
#endif
}
}