CheckBox.cs source code in C# .NET

Source code for the .NET framework in C#

                        

Code:

/ FXUpdate3074 / FXUpdate3074 / 1.1 / DEVDIV / depot / DevDiv / releases / whidbey / QFE / ndp / fx / src / xsp / System / Web / UI / WebControls / CheckBox.cs / 4 / CheckBox.cs

                            //------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------------------- 

namespace System.Web.UI.WebControls { 
    using AttributeCollection = System.Web.UI.AttributeCollection; 
    using System;
    using System.Collections; 
    using System.Collections.Specialized;
    using System.ComponentModel;
    using System.Globalization;
    using System.Security.Permissions; 
    using System.Web;
    using System.Web.UI; 
    using System.Web.UI.Adapters; 

 
    /// 
    ///    Represents a Windows checkbox control.
    /// 
    [ 
    ControlValueProperty("Checked"),
    DataBindingHandler("System.Web.UI.Design.TextDataBindingHandler, " + AssemblyRef.SystemDesign), 
    DefaultEvent("CheckedChanged"), 
    Designer("System.Web.UI.Design.WebControls.CheckBoxDesigner, " + AssemblyRef.SystemDesign),
    DefaultProperty("Text"), 
    SupportsEventValidation,
    ]
    [AspNetHostingPermission(SecurityAction.LinkDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)] 
    public class CheckBox : WebControl, IPostBackDataHandler, ICheckBoxControl {
        internal AttributeCollection _inputAttributes; 
        private StateBag _inputAttributesState; 
        private AttributeCollection _labelAttributes;
        private StateBag _labelAttributesState; 
        private string _valueAttribute = null;

        private static readonly object EventCheckedChanged = new object();
 

        ///  
        /// Initializes a new instance of the  class. 
        /// 
        public CheckBox() : base(HtmlTextWriterTag.Input) { 
        }


        ///  
        /// Gets or sets a value indicating that the  state is automatically posted back to
        ///    the 
        ///    server. 
        /// 
        [ 
        DefaultValue(false),
        WebCategory("Behavior"),
        WebSysDescription(SR.CheckBox_AutoPostBack),
        Themeable(false), 
        ]
        public virtual bool AutoPostBack { 
            get { 
                object b = ViewState["AutoPostBack"];
                return((b == null) ? false : (bool)b); 
            }
            set {
                ViewState["AutoPostBack"] = value;
            } 
        }
 
 
        [
        DefaultValue(false), 
        WebCategory("Behavior"),
        WebSysDescription(SR.AutoPostBackControl_CausesValidation),
        Themeable(false),
        ] 
        public virtual bool CausesValidation {
            get { 
                object b = ViewState["CausesValidation"]; 
                return((b == null) ? false : (bool)b);
            } 
            set {
                ViewState["CausesValidation"] = value;
            }
        } 

 
        ///  
        ///    Gets or sets a value indicating the checked state of the
        ///    . 
        /// 
        [
        Bindable(true, BindingDirection.TwoWay),
        DefaultValue(false), 
        Themeable(false),
        WebSysDescription(SR.CheckBox_Checked), 
        ] 
        public virtual bool Checked {
            get { 
                object b = ViewState["Checked"];
                return((b == null) ? false : (bool)b);
            }
            set { 
                ViewState["Checked"] = value;
            } 
        } 

 
        /// 
        ///    Attribute collection for the rendered input element.
        /// 
        [ 
        Browsable(false),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden), 
        WebSysDescription(SR.CheckBox_InputAttributes) 
        ]
        public AttributeCollection InputAttributes { 
            get {
                if (_inputAttributes == null) {

                    if (_inputAttributesState == null) { 
                        _inputAttributesState = new StateBag(true);
                        if (IsTrackingViewState) 
                            _inputAttributesState.TrackViewState(); 
                    }
 
                    _inputAttributes = new AttributeCollection(_inputAttributesState);
                }
                return _inputAttributes;
            } 
        }
 
 
        /// 
        ///    Attribute collection for the rendered span element. 
        /// 
        [
        Browsable(false),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden), 
        WebSysDescription(SR.CheckBox_LabelAttributes)
        ] 
        public AttributeCollection LabelAttributes { 
            get {
                if (_labelAttributes == null) { 

                    if (_labelAttributesState == null) {
                        _labelAttributesState = new StateBag(true);
                        if (IsTrackingViewState) 
                            _labelAttributesState.TrackViewState();
                    } 
 
                    _labelAttributes = new AttributeCollection(_labelAttributesState);
                } 
                return _labelAttributes;
            }
        }
 

        internal override bool RequiresLegacyRendering { 
            get { 
                return true;
            } 
        }


        ///  
        ///   Controls whether the Checked property is saved in ViewState.
        ///   This is used for optimizing the size of the view state. 
        ///  
        private bool SaveCheckedViewState(bool autoPostBack) {
            // Must be saved when 
            // 1. There is a registered event handler for SelectedIndexChanged
            // 2. Control is not enabled or visible, because the browser's post data will not include this control
            // 3. The instance is a derived instance, which might be overriding the OnSelectedIndexChanged method
            //    This is a bit hacky, since we have to cover all the four derived classes we have... 
            // 4. AutoPostBack is true and Adapter doesn't support JavaScript
            //    For CheckBoxes to behave the same on mobile devices 
            //    that simulate AutoPostBack by rendering a command button, we need to save 
            //    state
            // 

            if ((Events[EventCheckedChanged] != null) ||
                (IsEnabled == false) ||
                (Visible == false) || 
                (autoPostBack == true && ((Page != null) && !Page.ClientSupportsJavaScript))) {
 
                return true; 
            }
 
            Type t = this.GetType();
            if ((t == typeof(CheckBox)) || (t == typeof(RadioButton))) {
                return false;
            } 

            return true; 
        } 

 
        /// 
        /// Gets or sets the text label associated with the .
        /// 
        [ 
        Bindable(true),
        Localizable(true), 
        WebCategory("Appearance"), 
        DefaultValue(""),
        WebSysDescription(SR.CheckBox_Text) 
        ]
        public virtual string Text {
            get {
                string s = (string)ViewState["Text"]; 
                return((s == null) ? String.Empty : s);
            } 
            set { 
                ViewState["Text"] = value;
            } 
        }


        ///  
        /// Gets or sets the alignment of the  associated with the .
        ///  
        [ 
        WebCategory("Appearance"),
        DefaultValue(TextAlign.Right), 
        WebSysDescription(SR.WebControl_TextAlign)
        ]
        public virtual TextAlign TextAlign {
            get { 
                object align = ViewState["TextAlign"];
                return((align == null) ? TextAlign.Right : (TextAlign)align); 
            } 
            set {
                if (value < TextAlign.Left || value > TextAlign.Right) { 
                    throw new ArgumentOutOfRangeException("value");
                }
                ViewState["TextAlign"] = value;
            } 
        }
 
 
        [
        DefaultValue(""), 
        Themeable(false),
        WebCategory("Behavior"),
        WebSysDescription(SR.PostBackControl_ValidationGroup),
        ] 
        public virtual string ValidationGroup {
            get { 
                string s = (string)ViewState["ValidationGroup"]; 
                return((s == null) ? String.Empty : s);
            } 
            set {
                ViewState["ValidationGroup"] = value;
            }
        } 

 
        ///  
        /// Occurs when the  is clicked.
        ///  
        [
        WebCategory("Action"),
        WebSysDescription(SR.Control_OnServerCheckChanged)
        ] 
        public event EventHandler CheckedChanged {
            add { 
                Events.AddHandler(EventCheckedChanged, value); 
            }
            remove { 
                Events.RemoveHandler(EventCheckedChanged, value);
            }
        }
 

        ///  
        ///     Adds attributes to be rendered. 
        /// 
        protected override void AddAttributesToRender(HtmlTextWriter writer) { 
            //
            AddDisplayInlineBlockIfNeeded(writer);

            // Everett's behavior is that we didn't call the base method. 
        }
 
 
        /// 
        ///     Loads the view state for the control. 
        /// 
        protected override void LoadViewState(object savedState) {
            if (savedState != null) {
                Triplet stateTriplet = (Triplet)savedState; 
                base.LoadViewState(stateTriplet.First);
                if (stateTriplet.Second != null) { 
                    if (_inputAttributesState == null) { 
                        _inputAttributesState = new StateBag();
                        _inputAttributesState.TrackViewState(); 
                    }
                    _inputAttributesState.LoadViewState(stateTriplet.Second);
                }
                if (stateTriplet.Third != null) { 
                    if (_labelAttributesState == null) {
                        _labelAttributesState = new StateBag(); 
                        _labelAttributesState.TrackViewState(); 
                    }
                    _labelAttributesState.LoadViewState(stateTriplet.Second); 
                }
            }
        }
 

        ///  
        ///     Raises the 
        ///     event of the 
        ///    controls. 
        /// 
        protected virtual void OnCheckedChanged(EventArgs e) {
            EventHandler handler = (EventHandler)Events[EventCheckedChanged];
            if (handler != null) { 
                handler(this, e);
            } 
        } 

 
        /// 
        ///    Registers client script for generating postback prior to
        ///       rendering on the client if  is
        ///    . 
        /// 
        protected internal override void OnPreRender(EventArgs e) { 
            base.OnPreRender(e); 
            bool autoPostBack = AutoPostBack;
 
            if (Page != null && IsEnabled) {
                // we always need to get post back data
                Page.RegisterRequiresPostBack(this);
                if (autoPostBack) { 
                    Page.RegisterPostBackScript();
                    Page.RegisterFocusScript(); 
 
                    //
                    if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) { 
                        Page.RegisterWebFormsScript();
                    }
                }
            } 

            if (!SaveCheckedViewState(autoPostBack)) { 
                ViewState.SetItemDirty("Checked", false); 

                if ((Page != null) && IsEnabled) { 
                    // Store a client-side array of enabled control, so we can re-enable them on
                    // postback (in case they are disabled client-side)
                    Page.RegisterEnabledControl(this);
                } 
            }
        } 
 

        ///  
        ///     Saves the view state for the control.
        /// 
        protected override object SaveViewState() {
            object baseState = base.SaveViewState(); 
            object inputState = null;
            object labelState = null; 
            object myState = null; 

            if (_inputAttributesState != null) { 
                inputState = _inputAttributesState.SaveViewState();
            }
            if (_labelAttributesState != null) {
                labelState = _labelAttributesState.SaveViewState(); 
            }
            if (baseState != null || inputState != null || labelState != null) { 
                myState = new Triplet(baseState, inputState, labelState); 
            }
            return myState; 
        }


        ///  
        ///     Starts view state tracking.
        ///  
        protected override void TrackViewState() { 
            base.TrackViewState();
            if (_inputAttributesState != null) { 
                _inputAttributesState.TrackViewState();
            }
            if (_labelAttributesState != null) {
                _labelAttributesState.TrackViewState(); 
            }
        } 
 

        ///  
        /// 
        /// Displays the  on the client.
        /// 
        protected internal override void Render(HtmlTextWriter writer) { 
            AddAttributesToRender(writer);
 
            // Make sure we are in a form tag with runat=server. 
            if (Page != null) {
                Page.VerifyRenderingInServerForm(this); 
            }

            bool renderWrapper = false;
 
            // On wrapper, render the style,
            if (ControlStyleCreated) { 
                Style controlStyle = ControlStyle; 
                if (!controlStyle.IsEmpty) {
                    controlStyle.AddAttributesToRender(writer, this); 
                    renderWrapper = true;
                }
            }
            // And Enabled 
            if (!IsEnabled) {
                writer.AddAttribute(HtmlTextWriterAttribute.Disabled, "disabled"); 
                renderWrapper = true; 
            }
            // And ToolTip 
            string toolTip = ToolTip;
            if (toolTip.Length > 0) {
                writer.AddAttribute(HtmlTextWriterAttribute.Title, toolTip);
                renderWrapper = true; 
            }
 
            string onClick = null; 
            // And other attributes
            if (HasAttributes) { 
                AttributeCollection attribs = Attributes;

                // remove value from the attribute collection so it's not on the wrapper
                string val = attribs["value"]; 
                if (val != null)
                    attribs.Remove("value"); 
 
                // remove and save onclick from the attribute collection so we can move it to the input tag
                onClick = attribs["onclick"]; 
                if (onClick != null) {
                    onClick = Util.EnsureEndWithSemiColon(onClick);
                    attribs.Remove("onclick");
                } 

                if (attribs.Count != 0) 
                { 
                    attribs.AddAttributes(writer);
                    renderWrapper = true; 
                }

                if (val != null)
                    attribs["value"] = val; 
            }
 
            // render begin tag of wrapper SPAN 
            if (renderWrapper) {
                writer.RenderBeginTag(HtmlTextWriterTag.Span); 
            }

            string text = Text;
            string clientID = ClientID; 
            if (text.Length != 0) {
                if (TextAlign == TextAlign.Left) { 
                    // render label to left of checkbox 
                    RenderLabel(writer, text, clientID);
                    RenderInputTag(writer, clientID, onClick); 
                }
                else {
                    // render label to right of checkbox
                    RenderInputTag(writer, clientID, onClick); 
                    RenderLabel(writer, text, clientID);
                } 
            } 
            else
                RenderInputTag(writer, clientID, onClick); 

            // render end tag of wrapper SPAN
            if (renderWrapper) {
                writer.RenderEndTag(); 
            }
        } 
 
        private void RenderLabel(HtmlTextWriter writer, string text, string clientID) {
            writer.AddAttribute(HtmlTextWriterAttribute.For, clientID); 

            if (_labelAttributes != null && _labelAttributes.Count != 0) {
                _labelAttributes.AddAttributes(writer);
            } 

            writer.RenderBeginTag(HtmlTextWriterTag.Label); 
            writer.Write(text); 
            writer.RenderEndTag();
        } 

        internal virtual void RenderInputTag(HtmlTextWriter writer, string clientID, string onClick) {
            if (clientID != null) {
                writer.AddAttribute(HtmlTextWriterAttribute.Id, clientID); 
            }
 
            writer.AddAttribute(HtmlTextWriterAttribute.Type, "checkbox"); 

            if (UniqueID != null) { 
                writer.AddAttribute(HtmlTextWriterAttribute.Name, UniqueID);
            }

            // Whidbey 20815 
            if (_valueAttribute != null) {
                writer.AddAttribute(HtmlTextWriterAttribute.Value, _valueAttribute); 
            } 

            if (Checked) 
                writer.AddAttribute(HtmlTextWriterAttribute.Checked, "checked");

            // ASURT 119141: Render disabled attribute on the INPUT tag (instead of the SPAN) so the checkbox actually gets disabled when Enabled=false
            if (!IsEnabled) { 
                writer.AddAttribute(HtmlTextWriterAttribute.Disabled, "disabled");
            } 
 
            if (AutoPostBack && (Page != null) && Page.ClientSupportsJavaScript) {
 
                PostBackOptions options = new PostBackOptions(this, String.Empty);

                if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) {
                    options.PerformValidation = true; 
                    options.ValidationGroup = ValidationGroup;
                } 
 
                if (Page.Form != null) {
                    options.AutoPostBack = true; 
                }

                // ASURT 98368
                // Need to merge the autopostback script with the user script 
                onClick = Util.MergeScript(onClick, Page.ClientScript.GetPostBackEventReference(options, true));
                writer.AddAttribute(HtmlTextWriterAttribute.Onclick, onClick); 
 
                if (EnableLegacyRendering) {
                    writer.AddAttribute("language", "javascript", false); 
                }
            }
            else {
                if (Page != null) { 
                    Page.ClientScript.RegisterForEventValidation(this.UniqueID);
                } 
 
                if (onClick != null) {
                    writer.AddAttribute(HtmlTextWriterAttribute.Onclick, onClick); 
                }
            }

            string s = AccessKey; 
            if (s.Length > 0)
                writer.AddAttribute(HtmlTextWriterAttribute.Accesskey, s); 
 
            int i = TabIndex;
            if (i != 0) 
                writer.AddAttribute(HtmlTextWriterAttribute.Tabindex, i.ToString(NumberFormatInfo.InvariantInfo));

            if (_inputAttributes != null && _inputAttributes.Count != 0) {
                _inputAttributes.AddAttributes(writer); 
            }
 
            writer.RenderBeginTag(HtmlTextWriterTag.Input); 
            writer.RenderEndTag();
        } 

        /// 
        ///     Whidbey 20815
        ///  
#if SHIPPINGADAPTERS
        internal void SetValueAttribute(string value) { 
            _valueAttribute = value; 
        }
#endif 


        /// 
        ///  
        /// Processes posted data for the 
        /// control. 
        ///  
        bool IPostBackDataHandler.LoadPostData(string postDataKey, NameValueCollection postCollection) {
            return LoadPostData(postDataKey, postCollection); 
        }


        ///  
        /// 
        /// Processes posted data for the  
        /// control. 
        /// 
        protected virtual bool LoadPostData(string postDataKey, NameValueCollection postCollection) { 
            bool dataChanged = false;

            string post = postCollection[postDataKey];
 
            bool isChecked = (!String.IsNullOrEmpty(post));
 
            if (isChecked) { 
                ValidateEvent(postDataKey);
            } 

            dataChanged = (isChecked != Checked);
            Checked = isChecked;
 
            return dataChanged;
        } 
 

        ///  
        /// 
        /// Raises when posted data for a control has changed.
        /// 
        void IPostBackDataHandler.RaisePostDataChangedEvent() { 
            RaisePostDataChangedEvent();
        } 
 

        ///  
        /// 
        /// Raises when posted data for a control has changed.
        /// 
        protected virtual void RaisePostDataChangedEvent() { 
            if (AutoPostBack && !Page.IsPostBackEventControlRegistered) {
                // 
                Page.AutoPostBackControl = this; 

                if (CausesValidation) { 
                    Page.Validate(ValidationGroup);
                }
            }
            OnCheckedChanged(EventArgs.Empty); 
        }
    } 
} 


// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
//------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------------------- 

namespace System.Web.UI.WebControls { 
    using AttributeCollection = System.Web.UI.AttributeCollection; 
    using System;
    using System.Collections; 
    using System.Collections.Specialized;
    using System.ComponentModel;
    using System.Globalization;
    using System.Security.Permissions; 
    using System.Web;
    using System.Web.UI; 
    using System.Web.UI.Adapters; 

 
    /// 
    ///    Represents a Windows checkbox control.
    /// 
    [ 
    ControlValueProperty("Checked"),
    DataBindingHandler("System.Web.UI.Design.TextDataBindingHandler, " + AssemblyRef.SystemDesign), 
    DefaultEvent("CheckedChanged"), 
    Designer("System.Web.UI.Design.WebControls.CheckBoxDesigner, " + AssemblyRef.SystemDesign),
    DefaultProperty("Text"), 
    SupportsEventValidation,
    ]
    [AspNetHostingPermission(SecurityAction.LinkDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)] 
    public class CheckBox : WebControl, IPostBackDataHandler, ICheckBoxControl {
        internal AttributeCollection _inputAttributes; 
        private StateBag _inputAttributesState; 
        private AttributeCollection _labelAttributes;
        private StateBag _labelAttributesState; 
        private string _valueAttribute = null;

        private static readonly object EventCheckedChanged = new object();
 

        ///  
        /// Initializes a new instance of the  class. 
        /// 
        public CheckBox() : base(HtmlTextWriterTag.Input) { 
        }


        ///  
        /// Gets or sets a value indicating that the  state is automatically posted back to
        ///    the 
        ///    server. 
        /// 
        [ 
        DefaultValue(false),
        WebCategory("Behavior"),
        WebSysDescription(SR.CheckBox_AutoPostBack),
        Themeable(false), 
        ]
        public virtual bool AutoPostBack { 
            get { 
                object b = ViewState["AutoPostBack"];
                return((b == null) ? false : (bool)b); 
            }
            set {
                ViewState["AutoPostBack"] = value;
            } 
        }
 
 
        [
        DefaultValue(false), 
        WebCategory("Behavior"),
        WebSysDescription(SR.AutoPostBackControl_CausesValidation),
        Themeable(false),
        ] 
        public virtual bool CausesValidation {
            get { 
                object b = ViewState["CausesValidation"]; 
                return((b == null) ? false : (bool)b);
            } 
            set {
                ViewState["CausesValidation"] = value;
            }
        } 

 
        ///  
        ///    Gets or sets a value indicating the checked state of the
        ///    . 
        /// 
        [
        Bindable(true, BindingDirection.TwoWay),
        DefaultValue(false), 
        Themeable(false),
        WebSysDescription(SR.CheckBox_Checked), 
        ] 
        public virtual bool Checked {
            get { 
                object b = ViewState["Checked"];
                return((b == null) ? false : (bool)b);
            }
            set { 
                ViewState["Checked"] = value;
            } 
        } 

 
        /// 
        ///    Attribute collection for the rendered input element.
        /// 
        [ 
        Browsable(false),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden), 
        WebSysDescription(SR.CheckBox_InputAttributes) 
        ]
        public AttributeCollection InputAttributes { 
            get {
                if (_inputAttributes == null) {

                    if (_inputAttributesState == null) { 
                        _inputAttributesState = new StateBag(true);
                        if (IsTrackingViewState) 
                            _inputAttributesState.TrackViewState(); 
                    }
 
                    _inputAttributes = new AttributeCollection(_inputAttributesState);
                }
                return _inputAttributes;
            } 
        }
 
 
        /// 
        ///    Attribute collection for the rendered span element. 
        /// 
        [
        Browsable(false),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden), 
        WebSysDescription(SR.CheckBox_LabelAttributes)
        ] 
        public AttributeCollection LabelAttributes { 
            get {
                if (_labelAttributes == null) { 

                    if (_labelAttributesState == null) {
                        _labelAttributesState = new StateBag(true);
                        if (IsTrackingViewState) 
                            _labelAttributesState.TrackViewState();
                    } 
 
                    _labelAttributes = new AttributeCollection(_labelAttributesState);
                } 
                return _labelAttributes;
            }
        }
 

        internal override bool RequiresLegacyRendering { 
            get { 
                return true;
            } 
        }


        ///  
        ///   Controls whether the Checked property is saved in ViewState.
        ///   This is used for optimizing the size of the view state. 
        ///  
        private bool SaveCheckedViewState(bool autoPostBack) {
            // Must be saved when 
            // 1. There is a registered event handler for SelectedIndexChanged
            // 2. Control is not enabled or visible, because the browser's post data will not include this control
            // 3. The instance is a derived instance, which might be overriding the OnSelectedIndexChanged method
            //    This is a bit hacky, since we have to cover all the four derived classes we have... 
            // 4. AutoPostBack is true and Adapter doesn't support JavaScript
            //    For CheckBoxes to behave the same on mobile devices 
            //    that simulate AutoPostBack by rendering a command button, we need to save 
            //    state
            // 

            if ((Events[EventCheckedChanged] != null) ||
                (IsEnabled == false) ||
                (Visible == false) || 
                (autoPostBack == true && ((Page != null) && !Page.ClientSupportsJavaScript))) {
 
                return true; 
            }
 
            Type t = this.GetType();
            if ((t == typeof(CheckBox)) || (t == typeof(RadioButton))) {
                return false;
            } 

            return true; 
        } 

 
        /// 
        /// Gets or sets the text label associated with the .
        /// 
        [ 
        Bindable(true),
        Localizable(true), 
        WebCategory("Appearance"), 
        DefaultValue(""),
        WebSysDescription(SR.CheckBox_Text) 
        ]
        public virtual string Text {
            get {
                string s = (string)ViewState["Text"]; 
                return((s == null) ? String.Empty : s);
            } 
            set { 
                ViewState["Text"] = value;
            } 
        }


        ///  
        /// Gets or sets the alignment of the  associated with the .
        ///  
        [ 
        WebCategory("Appearance"),
        DefaultValue(TextAlign.Right), 
        WebSysDescription(SR.WebControl_TextAlign)
        ]
        public virtual TextAlign TextAlign {
            get { 
                object align = ViewState["TextAlign"];
                return((align == null) ? TextAlign.Right : (TextAlign)align); 
            } 
            set {
                if (value < TextAlign.Left || value > TextAlign.Right) { 
                    throw new ArgumentOutOfRangeException("value");
                }
                ViewState["TextAlign"] = value;
            } 
        }
 
 
        [
        DefaultValue(""), 
        Themeable(false),
        WebCategory("Behavior"),
        WebSysDescription(SR.PostBackControl_ValidationGroup),
        ] 
        public virtual string ValidationGroup {
            get { 
                string s = (string)ViewState["ValidationGroup"]; 
                return((s == null) ? String.Empty : s);
            } 
            set {
                ViewState["ValidationGroup"] = value;
            }
        } 

 
        ///  
        /// Occurs when the  is clicked.
        ///  
        [
        WebCategory("Action"),
        WebSysDescription(SR.Control_OnServerCheckChanged)
        ] 
        public event EventHandler CheckedChanged {
            add { 
                Events.AddHandler(EventCheckedChanged, value); 
            }
            remove { 
                Events.RemoveHandler(EventCheckedChanged, value);
            }
        }
 

        ///  
        ///     Adds attributes to be rendered. 
        /// 
        protected override void AddAttributesToRender(HtmlTextWriter writer) { 
            //
            AddDisplayInlineBlockIfNeeded(writer);

            // Everett's behavior is that we didn't call the base method. 
        }
 
 
        /// 
        ///     Loads the view state for the control. 
        /// 
        protected override void LoadViewState(object savedState) {
            if (savedState != null) {
                Triplet stateTriplet = (Triplet)savedState; 
                base.LoadViewState(stateTriplet.First);
                if (stateTriplet.Second != null) { 
                    if (_inputAttributesState == null) { 
                        _inputAttributesState = new StateBag();
                        _inputAttributesState.TrackViewState(); 
                    }
                    _inputAttributesState.LoadViewState(stateTriplet.Second);
                }
                if (stateTriplet.Third != null) { 
                    if (_labelAttributesState == null) {
                        _labelAttributesState = new StateBag(); 
                        _labelAttributesState.TrackViewState(); 
                    }
                    _labelAttributesState.LoadViewState(stateTriplet.Second); 
                }
            }
        }
 

        ///  
        ///     Raises the 
        ///     event of the 
        ///    controls. 
        /// 
        protected virtual void OnCheckedChanged(EventArgs e) {
            EventHandler handler = (EventHandler)Events[EventCheckedChanged];
            if (handler != null) { 
                handler(this, e);
            } 
        } 

 
        /// 
        ///    Registers client script for generating postback prior to
        ///       rendering on the client if  is
        ///    . 
        /// 
        protected internal override void OnPreRender(EventArgs e) { 
            base.OnPreRender(e); 
            bool autoPostBack = AutoPostBack;
 
            if (Page != null && IsEnabled) {
                // we always need to get post back data
                Page.RegisterRequiresPostBack(this);
                if (autoPostBack) { 
                    Page.RegisterPostBackScript();
                    Page.RegisterFocusScript(); 
 
                    //
                    if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) { 
                        Page.RegisterWebFormsScript();
                    }
                }
            } 

            if (!SaveCheckedViewState(autoPostBack)) { 
                ViewState.SetItemDirty("Checked", false); 

                if ((Page != null) && IsEnabled) { 
                    // Store a client-side array of enabled control, so we can re-enable them on
                    // postback (in case they are disabled client-side)
                    Page.RegisterEnabledControl(this);
                } 
            }
        } 
 

        ///  
        ///     Saves the view state for the control.
        /// 
        protected override object SaveViewState() {
            object baseState = base.SaveViewState(); 
            object inputState = null;
            object labelState = null; 
            object myState = null; 

            if (_inputAttributesState != null) { 
                inputState = _inputAttributesState.SaveViewState();
            }
            if (_labelAttributesState != null) {
                labelState = _labelAttributesState.SaveViewState(); 
            }
            if (baseState != null || inputState != null || labelState != null) { 
                myState = new Triplet(baseState, inputState, labelState); 
            }
            return myState; 
        }


        ///  
        ///     Starts view state tracking.
        ///  
        protected override void TrackViewState() { 
            base.TrackViewState();
            if (_inputAttributesState != null) { 
                _inputAttributesState.TrackViewState();
            }
            if (_labelAttributesState != null) {
                _labelAttributesState.TrackViewState(); 
            }
        } 
 

        ///  
        /// 
        /// Displays the  on the client.
        /// 
        protected internal override void Render(HtmlTextWriter writer) { 
            AddAttributesToRender(writer);
 
            // Make sure we are in a form tag with runat=server. 
            if (Page != null) {
                Page.VerifyRenderingInServerForm(this); 
            }

            bool renderWrapper = false;
 
            // On wrapper, render the style,
            if (ControlStyleCreated) { 
                Style controlStyle = ControlStyle; 
                if (!controlStyle.IsEmpty) {
                    controlStyle.AddAttributesToRender(writer, this); 
                    renderWrapper = true;
                }
            }
            // And Enabled 
            if (!IsEnabled) {
                writer.AddAttribute(HtmlTextWriterAttribute.Disabled, "disabled"); 
                renderWrapper = true; 
            }
            // And ToolTip 
            string toolTip = ToolTip;
            if (toolTip.Length > 0) {
                writer.AddAttribute(HtmlTextWriterAttribute.Title, toolTip);
                renderWrapper = true; 
            }
 
            string onClick = null; 
            // And other attributes
            if (HasAttributes) { 
                AttributeCollection attribs = Attributes;

                // remove value from the attribute collection so it's not on the wrapper
                string val = attribs["value"]; 
                if (val != null)
                    attribs.Remove("value"); 
 
                // remove and save onclick from the attribute collection so we can move it to the input tag
                onClick = attribs["onclick"]; 
                if (onClick != null) {
                    onClick = Util.EnsureEndWithSemiColon(onClick);
                    attribs.Remove("onclick");
                } 

                if (attribs.Count != 0) 
                { 
                    attribs.AddAttributes(writer);
                    renderWrapper = true; 
                }

                if (val != null)
                    attribs["value"] = val; 
            }
 
            // render begin tag of wrapper SPAN 
            if (renderWrapper) {
                writer.RenderBeginTag(HtmlTextWriterTag.Span); 
            }

            string text = Text;
            string clientID = ClientID; 
            if (text.Length != 0) {
                if (TextAlign == TextAlign.Left) { 
                    // render label to left of checkbox 
                    RenderLabel(writer, text, clientID);
                    RenderInputTag(writer, clientID, onClick); 
                }
                else {
                    // render label to right of checkbox
                    RenderInputTag(writer, clientID, onClick); 
                    RenderLabel(writer, text, clientID);
                } 
            } 
            else
                RenderInputTag(writer, clientID, onClick); 

            // render end tag of wrapper SPAN
            if (renderWrapper) {
                writer.RenderEndTag(); 
            }
        } 
 
        private void RenderLabel(HtmlTextWriter writer, string text, string clientID) {
            writer.AddAttribute(HtmlTextWriterAttribute.For, clientID); 

            if (_labelAttributes != null && _labelAttributes.Count != 0) {
                _labelAttributes.AddAttributes(writer);
            } 

            writer.RenderBeginTag(HtmlTextWriterTag.Label); 
            writer.Write(text); 
            writer.RenderEndTag();
        } 

        internal virtual void RenderInputTag(HtmlTextWriter writer, string clientID, string onClick) {
            if (clientID != null) {
                writer.AddAttribute(HtmlTextWriterAttribute.Id, clientID); 
            }
 
            writer.AddAttribute(HtmlTextWriterAttribute.Type, "checkbox"); 

            if (UniqueID != null) { 
                writer.AddAttribute(HtmlTextWriterAttribute.Name, UniqueID);
            }

            // Whidbey 20815 
            if (_valueAttribute != null) {
                writer.AddAttribute(HtmlTextWriterAttribute.Value, _valueAttribute); 
            } 

            if (Checked) 
                writer.AddAttribute(HtmlTextWriterAttribute.Checked, "checked");

            // ASURT 119141: Render disabled attribute on the INPUT tag (instead of the SPAN) so the checkbox actually gets disabled when Enabled=false
            if (!IsEnabled) { 
                writer.AddAttribute(HtmlTextWriterAttribute.Disabled, "disabled");
            } 
 
            if (AutoPostBack && (Page != null) && Page.ClientSupportsJavaScript) {
 
                PostBackOptions options = new PostBackOptions(this, String.Empty);

                if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) {
                    options.PerformValidation = true; 
                    options.ValidationGroup = ValidationGroup;
                } 
 
                if (Page.Form != null) {
                    options.AutoPostBack = true; 
                }

                // ASURT 98368
                // Need to merge the autopostback script with the user script 
                onClick = Util.MergeScript(onClick, Page.ClientScript.GetPostBackEventReference(options, true));
                writer.AddAttribute(HtmlTextWriterAttribute.Onclick, onClick); 
 
                if (EnableLegacyRendering) {
                    writer.AddAttribute("language", "javascript", false); 
                }
            }
            else {
                if (Page != null) { 
                    Page.ClientScript.RegisterForEventValidation(this.UniqueID);
                } 
 
                if (onClick != null) {
                    writer.AddAttribute(HtmlTextWriterAttribute.Onclick, onClick); 
                }
            }

            string s = AccessKey; 
            if (s.Length > 0)
                writer.AddAttribute(HtmlTextWriterAttribute.Accesskey, s); 
 
            int i = TabIndex;
            if (i != 0) 
                writer.AddAttribute(HtmlTextWriterAttribute.Tabindex, i.ToString(NumberFormatInfo.InvariantInfo));

            if (_inputAttributes != null && _inputAttributes.Count != 0) {
                _inputAttributes.AddAttributes(writer); 
            }
 
            writer.RenderBeginTag(HtmlTextWriterTag.Input); 
            writer.RenderEndTag();
        } 

        /// 
        ///     Whidbey 20815
        ///  
#if SHIPPINGADAPTERS
        internal void SetValueAttribute(string value) { 
            _valueAttribute = value; 
        }
#endif 


        /// 
        ///  
        /// Processes posted data for the 
        /// control. 
        ///  
        bool IPostBackDataHandler.LoadPostData(string postDataKey, NameValueCollection postCollection) {
            return LoadPostData(postDataKey, postCollection); 
        }


        ///  
        /// 
        /// Processes posted data for the  
        /// control. 
        /// 
        protected virtual bool LoadPostData(string postDataKey, NameValueCollection postCollection) { 
            bool dataChanged = false;

            string post = postCollection[postDataKey];
 
            bool isChecked = (!String.IsNullOrEmpty(post));
 
            if (isChecked) { 
                ValidateEvent(postDataKey);
            } 

            dataChanged = (isChecked != Checked);
            Checked = isChecked;
 
            return dataChanged;
        } 
 

        ///  
        /// 
        /// Raises when posted data for a control has changed.
        /// 
        void IPostBackDataHandler.RaisePostDataChangedEvent() { 
            RaisePostDataChangedEvent();
        } 
 

        ///  
        /// 
        /// Raises when posted data for a control has changed.
        /// 
        protected virtual void RaisePostDataChangedEvent() { 
            if (AutoPostBack && !Page.IsPostBackEventControlRegistered) {
                // 
                Page.AutoPostBackControl = this; 

                if (CausesValidation) { 
                    Page.Validate(ValidationGroup);
                }
            }
            OnCheckedChanged(EventArgs.Empty); 
        }
    } 
} 


// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.

                        

Link Menu

Network programming in C#, Network Programming in VB.NET, Network Programming in .NET
This book is available now!
Buy at Amazon US or
Buy at Amazon UK