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;
46 bool requiresDataBinding;
48 protected BaseDataBoundControl ()
52 /* Used for controls that used to inherit from
53 * WebControl, so the tag can propagate upwards
55 internal BaseDataBoundControl (HtmlTextWriterTag tag) : base (tag)
59 [BindableAttribute (true)]
60 [ThemeableAttribute (false)]
61 [DefaultValueAttribute (null)]
62 [DesignerSerializationVisibilityAttribute (DesignerSerializationVisibility.Hidden)]
63 public virtual object DataSource {
68 ValidateDataSource (value);
71 OnDataPropertyChanged ();
75 [DefaultValueAttribute ("")]
76 [ThemeableAttribute (false)]
77 public virtual string DataSourceID {
79 return dataSourceId != null ? dataSourceId : string.Empty;
84 OnDataPropertyChanged ();
88 protected bool Initialized {
89 get { return initialized; }
92 protected bool IsBoundUsingDataSourceID {
93 get { return DataSourceID.Length > 0; }
96 protected bool RequiresDataBinding {
97 get { return requiresDataBinding; }
98 set { requiresDataBinding = value; }
101 protected void ConfirmInitState ()
106 public override void DataBind ()
108 RequiresDataBinding = false;
112 protected virtual void EnsureDataBound ()
114 if (RequiresDataBinding && IsBoundUsingDataSourceID)
118 protected virtual void OnDataBound (EventArgs e)
120 if (DataBound != null)
124 protected virtual void OnDataPropertyChanged ()
126 RequiresDataBinding = true;
129 protected internal override void OnInit (EventArgs e)
132 Page.PreLoad += new EventHandler (OnPagePreLoad);
135 protected virtual void OnPagePreLoad (object sender, EventArgs e)
140 protected internal override void OnPreRender (EventArgs e)
143 base.OnPreRender (e);
146 protected abstract void PerformSelect ();
148 protected abstract void ValidateDataSource (object dataSource);