2 // System.Web.UI.WebControls.BaseDataBoundControl.cs
5 // Lluis Sanchez Gual (lluis@novell.com)
7 // (C) 2004 Novell, Inc (http://www.novell.com)
11 // Permission is hereby granted, free of charge, to any person obtaining
12 // a copy of this software and associated documentation files (the
13 // "Software"), to deal in the Software without restriction, including
14 // without limitation the rights to use, copy, modify, merge, publish,
15 // distribute, sublicense, and/or sell copies of the Software, and to
16 // permit persons to whom the Software is furnished to do so, subject to
17 // the following conditions:
19 // The above copyright notice and this permission notice shall be
20 // included in all copies or substantial portions of the Software.
22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
32 using System.Collections;
33 using System.ComponentModel;
35 namespace System.Web.UI.WebControls
37 [DefaultProperty ("DataSourceID")]
38 [DesignerAttribute ("System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner, " + Consts.AssemblySystem_Design, "System.ComponentModel.Design.IDesigner")]
39 public abstract class BaseDataBoundControl: WebControl
41 public event EventHandler DataBound;
45 bool requiresDataBinding;
47 protected BaseDataBoundControl ()
51 /* Used for controls that used to inherit from
52 * WebControl, so the tag can propagate upwards
54 internal BaseDataBoundControl (HtmlTextWriterTag tag) : base (tag)
58 [BindableAttribute (true)]
59 [ThemeableAttribute (false)]
60 [DefaultValueAttribute (null)]
61 [DesignerSerializationVisibilityAttribute (DesignerSerializationVisibility.Hidden)]
62 public virtual object DataSource {
67 ValidateDataSource (value);
70 OnDataPropertyChanged ();
74 [DefaultValueAttribute ("")]
75 [ThemeableAttribute (false)]
76 public virtual string DataSourceID {
78 return ViewState.GetString ("DataSourceID", "");
81 ViewState["DataSourceID"] = value;
83 OnDataPropertyChanged ();
87 protected bool Initialized {
88 get { return initialized; }
91 protected bool IsBoundUsingDataSourceID {
92 get { return DataSourceID.Length > 0; }
95 protected bool RequiresDataBinding {
96 get { return requiresDataBinding; }
97 set { requiresDataBinding = value; }
100 protected void ConfirmInitState ()
105 public override void DataBind ()
107 RequiresDataBinding = false;
111 protected virtual void EnsureDataBound ()
113 if (RequiresDataBinding && IsBoundUsingDataSourceID)
117 protected virtual void OnDataBound (EventArgs e)
119 if (DataBound != null)
123 protected virtual void OnDataPropertyChanged ()
125 RequiresDataBinding = true;
128 protected internal override void OnInit (EventArgs e)
131 Page.PreLoad += new EventHandler (OnPagePreLoad);
134 protected virtual void OnPagePreLoad (object sender, EventArgs e)
139 protected internal override void OnPreRender (EventArgs e)
142 base.OnPreRender (e);
145 protected abstract void PerformSelect ();
147 protected abstract void ValidateDataSource (object dataSource);