HtmlAnchor.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 / HtmlControls / HtmlAnchor.cs / 3 / 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, 
    ] 
    [AspNetHostingPermission(SecurityAction.LinkDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)] 
    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();
 
                // 
                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.
//------------------------------------------------------------------------------ 
// 
//     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, 
    ] 
    [AspNetHostingPermission(SecurityAction.LinkDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)] 
    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();
 
                // 
                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.

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