HtmlAnchor.RenderAttributes(HtmlTextWriter) Methode

Definitie

Naamruimte:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Geeft de kenmerken van het HtmlAnchor besturingselement weer voor het opgegeven HtmlTextWriter object.

protected:
 override void RenderAttributes(System::Web::UI::HtmlTextWriter ^ writer);
protected override void RenderAttributes(System.Web.UI.HtmlTextWriter writer);
override this.RenderAttributes : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub RenderAttributes (writer As HtmlTextWriter)

Parameters

writer
HtmlTextWriter

De HtmlTextWriter uitvoerstroom die moet worden weergegeven op de client.

Uitzonderingen

HttpException

De HRef url bevat een ongeldige URL.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de RenderAttributes methode in een aangepast serverbesturingselement overschrijft, zodat specifieke titeltekst, toegankelijk als knopinfo, altijd wordt weergegeven voor het HtmlAnchor besturingselement.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ 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>Custom HtmlAnchor - RenderAttributes - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      Top of Page
      <<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor1"
           runat="server"
           name="HtmlAnchor1">HtmlAnchor1</aspSample:CustomHtmlAnchorRenderAttributes>>

      <h3>Custom HtmlAnchor - RenderAttributes - C# Example</h3>
      <p>Place the mouse pointer over the HtmlAnchor1 tag (above). A Title attribute was added from within the RenderAttributes override method.</p>
      <p>Jump to <a href="#HtmlAnchor2">HtmlAnchor2</a> below.</p>

      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>

      <p>Jump to <a href="#HtmlAnchor1">HtmlAnchor1</a> above.</p>
      <p> </p>Bottom of Page
      <<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor2"
           runat="server"
           name="HtmlAnchor2">HtmlAnchor2</aspSample:CustomHtmlAnchorRenderAttributes>>
    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ 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>Custom HtmlAnchor - RenderAttributes - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      Top of Page
      <<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor1"
           runat="server"
           name="HtmlAnchor1">HtmlAnchor1</aspSample:CustomHtmlAnchorRenderAttributes>>

      <h3>Custom HtmlAnchor - RenderAttributes - Visual Basic Example</h3>
      <p>Place the mouse pointer over the HtmlAnchor1 tag (above). A Title attribute was added from within the RenderAttributes override method.</p>
      <p>Jump to <a href="#HtmlAnchor2">HtmlAnchor2</a> below.</p>

      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>
      <p> </p><p> </p><p> </p><p> </p>

      <p>Jump to <a href="#HtmlAnchor1">HtmlAnchor1</a> above.</p>
      <p> </p>Bottom of Page
      <<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor2"
           runat="server"
           name="HtmlAnchor2">HtmlAnchor2</aspSample:CustomHtmlAnchorRenderAttributes>>
    </form>
  </body>
</html>

using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomHtmlAnchorRenderAttributes : System.Web.UI.HtmlControls.HtmlAnchor
    {
        protected override void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
        {
            // Call the base class's RenderAttributes method.
            base.RenderAttributes(writer);
            
            // Write out the HtmlAnchor control's Title tag.
            writer.Write(" Title=\"Text from RenderAttributes.\"");
        }
    }
}

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomHtmlAnchorRenderAttributes
        Inherits System.Web.UI.HtmlControls.HtmlAnchor

        Protected Overrides Sub RenderAttributes(ByVal writer As System.Web.UI.HtmlTextWriter)

            ' Call the base class's RenderAttributes method.
            MyBase.RenderAttributes(writer)

            ' Write out the HtmlAnchor control's Title tag.
            writer.Write(" Title=""Text from RenderAttributes.""")
        End Sub
    End Class
End Namespace

Opmerkingen

Als de waarde van de HRef eigenschap een onjuiste URL is, genereert de RenderAttributes methode een HttpException uitzondering.

Van toepassing op

Zie ook