System.Web 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Web.UI.HtmlControls.HtmlContainerControl System.Web.UI.IPostBackEventHandler System.Web.UI.SupportsEventValidation System.ComponentModel.DefaultEvent("ServerClick")

There are two ways to use the class. The first is for navigation: using the property to define the location of the page to link to. The second is for postback events: using the event to programmatically handle the user's clicking a link.

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Validation Server Controls.

For a list of initial property values for an instance of , see the constructor.

Allows programmatic access to the HTML <a> element on the server.

- Constructor

  Use this constructor to create and initialize a new instance of the control.

  The following table shows the initial property value for an instance of .

  Property

  Initial Value

  The "a" literal string.

  Initializes a new instance of the class.

  1.0.5000.0
  2.0.0.0
- Property
  2.0.0.0
  System.ComponentModel.DefaultValue(true)
  System.Boolean To be added.

  By default, page validation is performed when an control is clicked. Page validation determines whether controls that are associated with a validation control on the page all pass the validation rules that are specified by the validation control.

  You can specify or determine whether validation is performed on both the client and the server when an control is clicked by using the property. To prevent validation from being performed, set the property to false.

  Gets or sets a value indicating whether validation is performed when the control is clicked.

- Property
  System.String To be added: an object of type 'string'

  Use this property to specify the URL to link to when the control is clicked.

  Gets or sets the URL target of the link specified in the server control.

  1.0.5000.0
  2.0.0.0
  System.Web.UI.UrlProperty
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  System.String To be added: an object of type 'string'

  Use this property to mark a section on a Web page with a name. This allows you to link to this section from anywhere on the same page. For example, you can provide a table of contents at the top of a page that will link directly to topics on the page.

  To link to a marked section, use an control with the property set to the name of the section, preceded by a # symbol (<a HRef= "#Topic1"/>).

  Gets or sets the bookmark name defined in the server control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Method
  System.Void `` To be added

  Raises the event and registers client script for generating a postback.

  An that contains the event data. 1.0.5000.0 2.0.0.0
- Method
  System.Void ``

  The event is raised when the control is clicked. This server event causes a round trip to occur from the client to the server and back.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event. This allows you to provide a custom handler for the event.

  An that contains event data. 1.0.5000.0 2.0.0.0
- Method
  2.0.0.0
  System.Void ``

  The method is used by the control, when it is clicked, to raise a event.

  This method is used primarily by control developers extending the functionality of the control.

  Raises events for the control when it posts back to the server.

  The argument for the event.
- Method
  System.Void ``

  If the value of the property is a malformed URL, the method throws an exception.

  Renders the control's attributes to the specified object.

  The that contains the output stream to render on the client. 1.0.5000.0 2.0.0.0
- Event
  System.EventHandler

  The event is raised when the control is clicked. This server event causes a round trip to occur from the client to the server and back.

  For more information about handling events, see Consuming Events.

  Occurs when the control is clicked.

  1.0.5000.0
  2.0.0.0
- Method
  1.0.5000.0
  2.0.0.0
  System.Void ``

  The method calls the method.

  This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.

  For a description of this member, see .

  The event arguments.
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the target window or frame that displays the contents of the Web page that is linked to when the control is clicked.

  The property renders as a target attribute. The target attribute on a elements is not allowed in the XHTML 1.1 document type definition. Do not set the property if the rendered output for the must be compliant with XHTML 1.1. For more information, see ASP.NET and XHTML Compliance.

  When creating accessible Web pages, avoid using the property to target another window. For more information, see ASP.NET Accessibility.

  The value must begin with a letter in the range of A to Z (case-insensitive), except for the following special values, which begin with an underscore.

  Target value

  Description

  _blank

  Renders the content in a new window without frames.

  _parent

  Renders the content in the immediate frameset parent.

  _search

  Renders the content in the search pane.

  _self

  Renders the content in the frame with focus.

  _top

  Renders the content in the full window without frames.

  Check your browser documentation to determine if the _search value is supported. For example, Microsoft Internet Explorer 5.0 and later support the _search target value.

  Gets or sets the name of the browser window or frame that displays the contents of the Web page that is linked to when the control is clicked.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  System.String To be added: an object of type 'string'

  Use this property to provide a custom ToolTip for the control. This text is displayed when the mouse pointer rests over the control.

  Gets or sets the ToolTip text displayed when the mouse pointer is placed over the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.Localizable(true)
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Property
  2.0.0.0
  System.ComponentModel.DefaultValue("")
  System.String To be added.

  Validation groups allow you to assign validation controls on a page to a specific category. Each validation group can be validated independently of other validation groups on the page. Use the property to specify the name of the validation group for which the control causes validation when it posts back to the server.

  The property has an effect only when the value of the property is set to true. When you specify a value for the property, only the validation controls that are part of the specified group are validated when the control posts back to the server. If you do not specify a value for this property and the property is set to true, all validation controls on the page that are not assigned to a validation group are validated when the control posts back to the server.

  Gets or sets the group of controls for which the control causes validation when it posts back to the server.