HtmlAnchor.cs source code in C# .NET

                        Code:
                         / 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / xsp / System / Web / UI / HtmlControls / HtmlAnchor.cs / 1305376 / HtmlAnchor.cs
                        
                        
                            //------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------------------- 

/* 
 * HtmlAnchor.cs 
 *
 * Copyright (c) 2000 Microsoft Corporation 
 */

namespace System.Web.UI.HtmlControls {
    using System.ComponentModel; 
    using System;
    using System.Collections; 
    using System.Web; 
    using System.Web.UI;
    using System.Web.Util; 
    using System.Security.Permissions;


    ///  
    /// The 
    /// class defines the methods, properties, and 
    /// events for the HtmlAnchor control. 
    /// This
    /// class 
    /// allows programmatic access to the
    /// HTML <a> element on the server.
    /// 
    [ 
    DefaultEvent("ServerClick"),
    SupportsEventValidation, 
    ] 
    public class HtmlAnchor : HtmlContainerControl, IPostBackEventHandler {
 
        private static readonly object EventServerClick = new object();

        /*
         *  Creates an intrinsic Html A control. 
         */
 
        ///  
        /// Initializes a new instance of the  class.
        ///  
        public HtmlAnchor() : base("a") {
        }

        [ 
        WebCategory("Behavior"),
        DefaultValue(true), 
        ] 
        public virtual bool CausesValidation {
            get { 
                object b = ViewState["CausesValidation"];
                return((b == null) ? true : (bool)b);
            }
            set { 
                ViewState["CausesValidation"] = value;
            } 
        } 

        /* 
         * Href property.
         */

        ///  
        ///    Gets or sets the URL target of the link specified in the
        ///     
        ///    server control. 
        /// 
        [ 
        WebCategory("Navigation"),
        DefaultValue(""),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
        UrlProperty() 
        ]
        public string HRef { 
            get { 
                string s = Attributes["href"];
                return((s != null) ? s : String.Empty); 
            }
            set {
                Attributes["href"] = MapStringAttributeToString(value);
            } 
        }
 
        /* 
         * Name of group this radio is in.
         */ 

        /// 
        /// Gets or sets the bookmark name defined in the 
        /// server 
        /// control.
        ///  
        [ 
        WebCategory("Navigation"),
        DefaultValue(""), 
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
        ]
        public string Name {
            get { 
                string s = Attributes["name"];
                return((s != null) ? s : String.Empty); 
            } 
            set {
                Attributes["name"] = MapStringAttributeToString(value); 
            }
        }

        /* 
         * Target window property.
         */ 
 
        /// 
        ///     
        ///       Gets or
        ///       sets the target window or frame
        ///       to load linked Web page content into.
        ///     
        /// 
        [ 
        WebCategory("Navigation"), 
        DefaultValue(""),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden) 
        ]
        public string Target {
            get {
                string s = Attributes["target"]; 
                return((s != null) ? s : String.Empty);
            } 
            set { 
                Attributes["target"] = MapStringAttributeToString(value);
            } 
        }

        /*
         * Title property. 
         */
 
        ///  
        ///     Gets or sets the title that
        ///       the browser displays when identifying linked content. 
        /// 
        [
        WebCategory("Appearance"),
        Localizable(true), 
        DefaultValue(""),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden) 
        ] 
        public string Title {
            get { 
                string s = Attributes["title"];
                return((s != null) ? s : String.Empty);
            }
            set { 
                Attributes["title"] = MapStringAttributeToString(value);
            } 
        } 

        [ 
        WebCategory("Behavior"),
        DefaultValue(""),
        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 on the server when a user clicks the  control on the 
        ///    browser.
        ///  
        [
        WebCategory("Action"),
        WebSysDescription(SR.HtmlControl_OnServerClick)
        ] 
        public event EventHandler ServerClick {
            add { 
                Events.AddHandler(EventServerClick, value); 
            }
            remove { 
                Events.RemoveHandler(EventServerClick, value);
            }
        }
 
        private PostBackOptions GetPostBackOptions() {
            PostBackOptions options = new PostBackOptions(this, string.Empty); 
            options.RequiresJavaScriptProtocol = true; 

            if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) { 
                options.PerformValidation = true;
                options.ValidationGroup = ValidationGroup;
            }
 
            return options;
        } 
 
        /// 
        protected internal override void OnPreRender(EventArgs e) { 
            base.OnPreRender(e);
            if (Page != null && Events[EventServerClick] != null) {
                Page.RegisterPostBackScript();
 
                // VSWhidbey 489577
                if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) { 
                    Page.RegisterWebFormsScript(); 
                }
            } 
        }

        /*
         * Override to generate postback code for onclick. 
         */
 
        ///  
        /// 
        ///  
        protected override void RenderAttributes(HtmlTextWriter writer) {
            if (Events[EventServerClick] != null) {
                Attributes.Remove("href");
                base.RenderAttributes(writer); 

                PostBackOptions options = GetPostBackOptions(); 
                Debug.Assert(options != null); 
                string postBackEventReference = Page.ClientScript.GetPostBackEventReference(options, true);
 
                Debug.Assert(!string.IsNullOrEmpty(postBackEventReference));
                writer.WriteAttribute("href", postBackEventReference, true);
            }
            else { 
                PreProcessRelativeReferenceAttribute(writer, "href");
                base.RenderAttributes(writer); 
            } 
        }
 
        /*
         * Method used to raise the OnServerClick event.
         */
 
        /// 
        /// Raises the  
        /// event. 
        /// 
        protected virtual void OnServerClick(EventArgs e) { 
            EventHandler handler = (EventHandler)Events[EventServerClick];
            if (handler != null) handler(this, e);
        }
 
        /*
         * Method of IPostBackEventHandler interface to raise events on post back. 
         * Button fires an OnServerClick event. 
         */
 
        /// 
        /// 
        /// 
        void IPostBackEventHandler.RaisePostBackEvent(string eventArgument) { 
            RaisePostBackEvent(eventArgument);
        } 
 

        ///  
        /// 
        /// 
        protected virtual void RaisePostBackEvent(string eventArgument) {
            ValidateEvent(UniqueID, eventArgument); 

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

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

/* 
 * HtmlAnchor.cs 
 *
 * Copyright (c) 2000 Microsoft Corporation 
 */

namespace System.Web.UI.HtmlControls {
    using System.ComponentModel; 
    using System;
    using System.Collections; 
    using System.Web; 
    using System.Web.UI;
    using System.Web.Util; 
    using System.Security.Permissions;


    ///  
    /// The 
    /// class defines the methods, properties, and 
    /// events for the HtmlAnchor control. 
    /// This
    /// class 
    /// allows programmatic access to the
    /// HTML <a> element on the server.
    /// 
    [ 
    DefaultEvent("ServerClick"),
    SupportsEventValidation, 
    ] 
    public class HtmlAnchor : HtmlContainerControl, IPostBackEventHandler {
 
        private static readonly object EventServerClick = new object();

        /*
         *  Creates an intrinsic Html A control. 
         */
 
        ///  
        /// Initializes a new instance of the  class.
        ///  
        public HtmlAnchor() : base("a") {
        }

        [ 
        WebCategory("Behavior"),
        DefaultValue(true), 
        ] 
        public virtual bool CausesValidation {
            get { 
                object b = ViewState["CausesValidation"];
                return((b == null) ? true : (bool)b);
            }
            set { 
                ViewState["CausesValidation"] = value;
            } 
        } 

        /* 
         * Href property.
         */

        ///  
        ///    Gets or sets the URL target of the link specified in the
        ///     
        ///    server control. 
        /// 
        [ 
        WebCategory("Navigation"),
        DefaultValue(""),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
        UrlProperty() 
        ]
        public string HRef { 
            get { 
                string s = Attributes["href"];
                return((s != null) ? s : String.Empty); 
            }
            set {
                Attributes["href"] = MapStringAttributeToString(value);
            } 
        }
 
        /* 
         * Name of group this radio is in.
         */ 

        /// 
        /// Gets or sets the bookmark name defined in the 
        /// server 
        /// control.
        ///  
        [ 
        WebCategory("Navigation"),
        DefaultValue(""), 
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
        ]
        public string Name {
            get { 
                string s = Attributes["name"];
                return((s != null) ? s : String.Empty); 
            } 
            set {
                Attributes["name"] = MapStringAttributeToString(value); 
            }
        }

        /* 
         * Target window property.
         */ 
 
        /// 
        ///     
        ///       Gets or
        ///       sets the target window or frame
        ///       to load linked Web page content into.
        ///     
        /// 
        [ 
        WebCategory("Navigation"), 
        DefaultValue(""),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden) 
        ]
        public string Target {
            get {
                string s = Attributes["target"]; 
                return((s != null) ? s : String.Empty);
            } 
            set { 
                Attributes["target"] = MapStringAttributeToString(value);
            } 
        }

        /*
         * Title property. 
         */
 
        ///  
        ///     Gets or sets the title that
        ///       the browser displays when identifying linked content. 
        /// 
        [
        WebCategory("Appearance"),
        Localizable(true), 
        DefaultValue(""),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden) 
        ] 
        public string Title {
            get { 
                string s = Attributes["title"];
                return((s != null) ? s : String.Empty);
            }
            set { 
                Attributes["title"] = MapStringAttributeToString(value);
            } 
        } 

        [ 
        WebCategory("Behavior"),
        DefaultValue(""),
        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 on the server when a user clicks the  control on the 
        ///    browser.
        ///  
        [
        WebCategory("Action"),
        WebSysDescription(SR.HtmlControl_OnServerClick)
        ] 
        public event EventHandler ServerClick {
            add { 
                Events.AddHandler(EventServerClick, value); 
            }
            remove { 
                Events.RemoveHandler(EventServerClick, value);
            }
        }
 
        private PostBackOptions GetPostBackOptions() {
            PostBackOptions options = new PostBackOptions(this, string.Empty); 
            options.RequiresJavaScriptProtocol = true; 

            if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) { 
                options.PerformValidation = true;
                options.ValidationGroup = ValidationGroup;
            }
 
            return options;
        } 
 
        /// 
        protected internal override void OnPreRender(EventArgs e) { 
            base.OnPreRender(e);
            if (Page != null && Events[EventServerClick] != null) {
                Page.RegisterPostBackScript();
 
                // VSWhidbey 489577
                if (CausesValidation && Page.GetValidators(ValidationGroup).Count > 0) { 
                    Page.RegisterWebFormsScript(); 
                }
            } 
        }

        /*
         * Override to generate postback code for onclick. 
         */
 
        ///  
        /// 
        ///  
        protected override void RenderAttributes(HtmlTextWriter writer) {
            if (Events[EventServerClick] != null) {
                Attributes.Remove("href");
                base.RenderAttributes(writer); 

                PostBackOptions options = GetPostBackOptions(); 
                Debug.Assert(options != null); 
                string postBackEventReference = Page.ClientScript.GetPostBackEventReference(options, true);
 
                Debug.Assert(!string.IsNullOrEmpty(postBackEventReference));
                writer.WriteAttribute("href", postBackEventReference, true);
            }
            else { 
                PreProcessRelativeReferenceAttribute(writer, "href");
                base.RenderAttributes(writer); 
            } 
        }
 
        /*
         * Method used to raise the OnServerClick event.
         */
 
        /// 
        /// Raises the  
        /// event. 
        /// 
        protected virtual void OnServerClick(EventArgs e) { 
            EventHandler handler = (EventHandler)Events[EventServerClick];
            if (handler != null) handler(this, e);
        }
 
        /*
         * Method of IPostBackEventHandler interface to raise events on post back. 
         * Button fires an OnServerClick event. 
         */
 
        /// 
        /// 
        /// 
        void IPostBackEventHandler.RaisePostBackEvent(string eventArgument) { 
            RaisePostBackEvent(eventArgument);
        } 
 

        ///  
        /// 
        /// 
        protected virtual void RaisePostBackEvent(string eventArgument) {
            ValidateEvent(UniqueID, eventArgument); 

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

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
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
HtmlAnchor.cs source code in C# .NET

Source code for the .NET framework in C#

Code:

Link Menu
