Freigeben über


HtmlAnchor.RenderAttributes-Methode

Rendert die Attribute des HtmlAnchor-Steuerelements in das angegebene HtmlTextWriter-Objekt.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overrides Sub RenderAttributes ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.RenderAttributes(writer)
protected override void RenderAttributes (
    HtmlTextWriter writer
)
protected:
virtual void RenderAttributes (
    HtmlTextWriter^ writer
) override
protected void RenderAttributes (
    HtmlTextWriter writer
)
protected override function RenderAttributes (
    writer : HtmlTextWriter
)

Parameter

  • writer
    Der HtmlTextWriter, der den Ausgabestream enthält, der auf dem Client gerendert werden soll.

Ausnahmen

Ausnahmetyp Bedingung

HttpException

HRef enthält einen fehlerhaften URL.

Hinweise

Wenn der Wert der HRef-Eigenschaft ein fehlerhafter URL ist, löst die RenderAttributes-Methode eine HttpException-Ausnahme aus.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der RenderAttributes-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass im HtmlAnchor-Steuerelement immer ein bestimmter Titel angezeigt wird, der auch als QuickInfo verfügbar ist.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlAnchor - RenderAttributes - Visual Basic Example</title>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      Top of Page
      &lt;<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor1"
           runat="server"
           name="HtmlAnchor1">HtmlAnchor1</aspSample:CustomHtmlAnchorRenderAttributes>&gt;

      <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>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>

      <P>Jump to <A href="#HtmlAnchor1">HtmlAnchor1</A> above.</P>
      <P>&nbsp;</P>Bottom of Page
      &lt;<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor2"
           runat="server"
           name="HtmlAnchor2">HtmlAnchor2</aspSample:CustomHtmlAnchorRenderAttributes>&gt;
    </form>
  </body>
</HTML>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlAnchor - RenderAttributes - C# Example</title>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      Top of Page
      &lt;<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor1"
           runat="server"
           name="HtmlAnchor1">HtmlAnchor1</aspSample:CustomHtmlAnchorRenderAttributes>&gt;

      <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>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>

      <P>Jump to <A href="#HtmlAnchor1">HtmlAnchor1</A> above.</P>
      <P>&nbsp;</P>Bottom of Page
      &lt;<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor2"
           runat="server"
           name="HtmlAnchor2">HtmlAnchor2</aspSample:CustomHtmlAnchorRenderAttributes>&gt;
    </form>
  </body>
</HTML>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlAnchor - RenderAttributes - VJ# Example</title>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      Top of Page
      &lt;<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor1"
           runat="server"
           name="HtmlAnchor1">HtmlAnchor1</aspSample:CustomHtmlAnchorRenderAttributes>&gt;

      <h3>Custom HtmlAnchor - RenderAttributes - VJ# Example</h3>
      <P>Place the cursor 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>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>
      <P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P><P>&nbsp;</P>

      <P>Jump to <A href="#HtmlAnchor1">HtmlAnchor1</A> above.</P>
      <P>&nbsp;</P>Bottom of Page
      &lt;<aspSample:CustomHtmlAnchorRenderAttributes
           id="HtmlAnchor2"
           runat="server"
           name="HtmlAnchor2">HtmlAnchor2</aspSample:CustomHtmlAnchorRenderAttributes>&gt;
    </form>
  </body>
</HTML>
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
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.\"");
        }
    }
}
package Samples.AspNet.JSL.Controls;

public class CustomHtmlAnchorRenderAttributes
    extends System.Web.UI.HtmlControls.HtmlAnchor
{
    protected void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
    {
        // Call the base's RenderAttributes method.
        super.RenderAttributes(writer);
        // Write out Title tag
        writer.Write(" Title=\"Text from RenderAttributes.\"");
    } //RenderAttributes
} //CustomHtmlAnchorRenderAttributes

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlAnchor-Klasse
HtmlAnchor-Member
System.Web.UI.HtmlControls-Namespace
ResolveClientUrl
HRef

Weitere Ressourcen

HTML-Serversteuerelemente