HyperLinkControlBuilder HyperLinkControlBuilder HyperLinkControlBuilder HyperLinkControlBuilder Class

Definition

Interacts with the parser to build a HyperLink control.

public ref class HyperLinkControlBuilder : System::Web::UI::ControlBuilder
public class HyperLinkControlBuilder : System.Web.UI.ControlBuilder
type HyperLinkControlBuilder = class
    inherit ControlBuilder
Public Class HyperLinkControlBuilder
Inherits ControlBuilder
Inheritance
HyperLinkControlBuilderHyperLinkControlBuilderHyperLinkControlBuilderHyperLinkControlBuilder

Examples

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">


    <h3>HyperLink Sample</h3>

    Click on the HyperLink:<br />  

    <asp:HyperLink id="hyperlink1" 
                   NavigateUrl="http://www.microsoft.com"
                   Text="Microsoft Official Site"
                   Target="_new"
                   runat="server"/>       
</form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

    <h3>HyperLink Sample</h3>

    Click on the HyperLink:<br />  

    <asp:HyperLink id="hyperlink1" 
                   NavigateUrl="http://www.microsoft.com"
                   Text="Microsoft Official Site"
                   Target="_new"
                   runat="server"/>       

</form>
</body>
</html>

Notes to Inheritors

To create a custom control builder for a HyperLink derived control, you need to inherit from this class.

Constructors

HyperLinkControlBuilder() HyperLinkControlBuilder() HyperLinkControlBuilder() HyperLinkControlBuilder()

Initializes a new instance of the HyperLinkControlBuilder class.

Methods

AllowWhitespaceLiterals() AllowWhitespaceLiterals() AllowWhitespaceLiterals() AllowWhitespaceLiterals()

Gets a value that indicates whether white spaces are allowed in literals for this control.

AppendLiteralString(String) AppendLiteralString(String) AppendLiteralString(String) AppendLiteralString(String)

Adds the specified literal content to a control. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
AppendSubBuilder(ControlBuilder) AppendSubBuilder(ControlBuilder) AppendSubBuilder(ControlBuilder) AppendSubBuilder(ControlBuilder)

Adds builders to the ControlBuilder object for any child controls that belong to the container control.

(Inherited from ControlBuilder)
BuildObject() BuildObject() BuildObject() BuildObject()

Builds a design-time instance of the control that is referred to by this ControlBuilder object.

(Inherited from ControlBuilder)
CloseControl() CloseControl() CloseControl() CloseControl()

Called by the parser to inform the builder that the parsing of the control's opening and closing tags is complete.

(Inherited from ControlBuilder)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChildControlType(String, IDictionary) GetChildControlType(String, IDictionary) GetChildControlType(String, IDictionary) GetChildControlType(String, IDictionary)

Obtains the Type of the control type corresponding to a child tag. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetObjectPersistData() GetObjectPersistData() GetObjectPersistData() GetObjectPersistData()

Creates the ObjectPersistData object for this ControlBuilder object.

(Inherited from ControlBuilder)
GetResourceKey() GetResourceKey() GetResourceKey() GetResourceKey()

Retrieves the resource key for this ControlBuilder object.

(Inherited from ControlBuilder)
GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
HasBody() HasBody() HasBody() HasBody()

Determines if a control has both an opening and closing tag. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
HtmlDecodeLiterals() HtmlDecodeLiterals() HtmlDecodeLiterals() HtmlDecodeLiterals()

Determines whether the literal string of an HTML control must be HTML decoded. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary) Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary) Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary) Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary)

Initializes the ControlBuilder for use after it is instantiated. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
NeedsTagInnerText() NeedsTagInnerText() NeedsTagInnerText() NeedsTagInnerText()

Determines if the control builder needs to get its inner text. If so, the SetTagInnerText(String) method must be called. This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
OnAppendToParentBuilder(ControlBuilder) OnAppendToParentBuilder(ControlBuilder) OnAppendToParentBuilder(ControlBuilder) OnAppendToParentBuilder(ControlBuilder)

Notifies the ControlBuilder that it is being added to a parent control builder.

(Inherited from ControlBuilder)
ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod) ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod) ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod) ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod)

Enables custom control builders to access the generated Code Document Object Model (CodeDom) and insert and modify code during the process of parsing and building controls.

(Inherited from ControlBuilder)
SetResourceKey(String) SetResourceKey(String) SetResourceKey(String) SetResourceKey(String)

Sets the resource key for this ControlBuilder object.

(Inherited from ControlBuilder)
SetServiceProvider(IServiceProvider) SetServiceProvider(IServiceProvider) SetServiceProvider(IServiceProvider) SetServiceProvider(IServiceProvider)

Sets the service object for this ControlBuilder object.

(Inherited from ControlBuilder)
SetTagInnerText(String) SetTagInnerText(String) SetTagInnerText(String) SetTagInnerText(String)

Provides the ControlBuilder with the inner text of the control tag.

(Inherited from ControlBuilder)
ToString() ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)

Properties

BindingContainerBuilder BindingContainerBuilder BindingContainerBuilder BindingContainerBuilder

Gets the control builder that corresponds to the binding container for the control that this builder creates.

(Inherited from ControlBuilder)
BindingContainerType BindingContainerType BindingContainerType BindingContainerType

Gets the type of the binding container for the control that this builder creates.

(Inherited from ControlBuilder)
ComplexPropertyEntries ComplexPropertyEntries ComplexPropertyEntries ComplexPropertyEntries

Gets a collection of complex property entries.

(Inherited from ControlBuilder)
ControlType ControlType ControlType ControlType

Gets the Type for the control to be created.

(Inherited from ControlBuilder)
CurrentFilterResolutionService CurrentFilterResolutionService CurrentFilterResolutionService CurrentFilterResolutionService

Gets an IFilterResolutionService object that is used to manage device-filter related services when parsing and persisting controls in the designer.

(Inherited from ControlBuilder)
DeclareType DeclareType DeclareType DeclareType

Gets the type that will be used by code generation to declare the control.

(Inherited from ControlBuilder)
FChildrenAsProperties FChildrenAsProperties FChildrenAsProperties FChildrenAsProperties

Gets a value that determines whether the control has a ParseChildrenAttribute with ChildrenAsProperties set to true.

(Inherited from ControlBuilder)
FIsNonParserAccessor FIsNonParserAccessor FIsNonParserAccessor FIsNonParserAccessor

Gets a value that determines whether the control implements the IParserAccessor interface.

(Inherited from ControlBuilder)
HasAspCode HasAspCode HasAspCode HasAspCode

Gets a value indicating whether the control contains any code blocks.

(Inherited from ControlBuilder)
ID ID ID ID

Gets or sets the identifier property for the control to be built.

(Inherited from ControlBuilder)
InDesigner InDesigner InDesigner InDesigner

Returns whether the ControlBuilder is running in the designer.

(Inherited from ControlBuilder)
InPageTheme InPageTheme InPageTheme InPageTheme

Gets a Boolean value indicating whether this ControlBuilder object is used to generate page themes.

(Inherited from ControlBuilder)
ItemType ItemType ItemType ItemType

Gets the type set on the binding container.

(Inherited from ControlBuilder)
Localize Localize Localize Localize

Gets a Boolean value indicating whether the control that is created by this ControlBuilder object is localized.

(Inherited from ControlBuilder)
NamingContainerType NamingContainerType NamingContainerType NamingContainerType

Gets the type of the naming container for the control that this builder creates.

(Inherited from ControlBuilder)
PageVirtualPath PageVirtualPath PageVirtualPath PageVirtualPath

Gets the virtual path of a page to be built by this ControlBuilder instance.

(Inherited from ControlBuilder)
Parser Parser Parser Parser

Gets the TemplateParser responsible for parsing the control.

(Inherited from ControlBuilder)
ServiceProvider ServiceProvider ServiceProvider ServiceProvider

Gets the service object for this ControlBuilder object.

(Inherited from ControlBuilder)
SubBuilders SubBuilders SubBuilders SubBuilders

Gets a list of child ControlBuilder objects for this ControlBuilder object.

(Inherited from ControlBuilder)
TagName TagName TagName TagName

Gets the tag name for the control to be built.

(Inherited from ControlBuilder)
TemplatePropertyEntries TemplatePropertyEntries TemplatePropertyEntries TemplatePropertyEntries

Gets a collection of template property entries.

(Inherited from ControlBuilder)
ThemeResolutionService ThemeResolutionService ThemeResolutionService ThemeResolutionService

Gets an IThemeResolutionService object that is used in design time to manage control themes and skins.

(Inherited from ControlBuilder)

Applies to

See Also