PageAdapter.RenderBeginHyperlink Methode

Referenz

Definition

Namespace:: System.Web.UI.Adapters

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt ein öffnendes Linktag in den Antwortstream.

Überlädt

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Schreibt ein öffnendes Linktag, das die Ziel-URL enthält, in den Antwortstream.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Schreibt ein öffnendes Linktag mit der Ziel-URL sowie eine Zugriffstaste in den Antwortstream.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Schreibt ein öffnendes Linktag, das die Ziel-URL enthält, in den Antwortstream.

public:
 virtual void RenderBeginHyperlink(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ targetUrl, bool encodeUrl, System::String ^ softkeyLabel);

public virtual void RenderBeginHyperlink (System.Web.UI.HtmlTextWriter writer, string targetUrl, bool encodeUrl, string softkeyLabel);

abstract member RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string -> unit
override this.RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string -> unit

Public Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String)

Parameter

writer: HtmlTextWriter

Der HtmlTextWriter, der Methoden für das Rendering der zielspezifischen Ausgabe enthält.

targetUrl: String

Der String-Wert mit der Ziel-URL des Links.

encodeUrl: Boolean

true, um den Ausgabestream mit HtmlAttributeEncode(String) zu codieren, andernfalls false.

softkeyLabel: String

Der String-Wert, der als Beschriftung einer Bildschirmtaste verwendet werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse mit dem Namen CustomPageAdapter der PageAdapter Klasse abgeleitet wird und die RenderBeginHyperlink Methode außer Kraft setzen kann. Die RenderBeginHyperlink Methode fügt einem Hyperlink ein Attribut src hinzu, das einen Verweis auf die aktuelle Seite enthält. Alle Links, die in Seiten gerendert werden, an die angefügt wird, CustomPageAdapter weisen das src Attribut auf.

using System;
using System.IO;
using System.Web;
using System.Web.UI;
using System.Web.UI.Adapters;

// A derived PageAdapter class.
public class CustomPageAdapter : PageAdapter
{
    // Override RenderBeginHyperlink to add an attribute that 
    // references the referring page.
    public override void RenderBeginHyperlink(
        HtmlTextWriter writer, string targetUrl,
        bool encodeUrl, string softkeyLabel, 
        string accessKey )
    {
        string url = null;

        // Add the src attribute, if referring page URL is available.
        if( Page != null && Page.Request != null &&
            Page.Request.Url != null )
        {
            url = Page.Request.Url.AbsoluteUri;
            if( encodeUrl )
                url = HttpUtility.HtmlAttributeEncode( url );
            writer.AddAttribute( "src", url );
        }

        // Add the accessKey attribute, if caller requested.
        if( accessKey != null && accessKey.Length == 1 )
            writer.AddAttribute( "accessKey", accessKey );

        // Add the href attribute, encode the URL if requested.
        if( encodeUrl )
            url = HttpUtility.HtmlAttributeEncode( targetUrl );
        else
            url = targetUrl;
        writer.AddAttribute( "href", url );

        // Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag( "a" );
    }
}

Imports System.IO
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.Adapters

' A derived PageAdapter class.
Public Class CustomPageAdapter
    Inherits PageAdapter

    ' Override RenderBeginHyperlink to add an attribute that 
    ' references the referring page.
    Public Overrides Sub RenderBeginHyperlink( _
        ByVal writer As HtmlTextWriter, ByVal targetUrl As String, _
        ByVal encodeUrl As Boolean, ByVal softkeyLabel As String, _
        ByVal accessKey As String)

        Dim url As String

        ' Add the src attribute, if referring page URL is available.
        If Not (Page Is Nothing) Then
            If Not (Page.Request Is Nothing) Then
                If Not (Page.Request.Url Is Nothing) Then

                    url = Page.Request.Url.AbsoluteUri
                    If encodeUrl Then
                        url = HttpUtility.HtmlAttributeEncode(url)
                    End If
                    writer.AddAttribute("src", url)
                End If
            End If
        End If

        ' Render the accessKey attribute, if requested.
        If Not (accessKey Is Nothing) Then
            If accessKey.Length = 1 Then
                writer.AddAttribute("accessKey", accessKey)
            End If
        End If

        ' Add the href attribute, encode the URL if requested.
        If (encodeUrl) Then
            url = HttpUtility.HtmlAttributeEncode(targetUrl)
        Else
            url = targetUrl
        End If
        writer.AddAttribute("href", url)

        ' Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag("a")

    End Sub
End Class

Hinweise

Die RenderBeginHyperlink Methode schreibt ein öffnender Hyperlinktag. Wenn writer es HtmlTextWritersich um das folgende Format handelt, weist dieses Tag das folgende Format auf:

<a href=" targetUrl ">

Hinweise für Vererber

Wenn Sie von der PageAdapter Klasse erben, können Sie die RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) Methode außer Kraft setzen, um ein anderes Format für ein öffnende Linktag zu schreiben oder zusätzliche Tagattribute zu schreiben. Die Basismethode schreibt z. B RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) . kein Attribut für softkeyLabel.

Siehe auch

Gilt für

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

Schreibt ein öffnendes Linktag mit der Ziel-URL sowie eine Zugriffstaste in den Antwortstream.

public:
 virtual void RenderBeginHyperlink(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ targetUrl, bool encodeUrl, System::String ^ softkeyLabel, System::String ^ accessKey);

public virtual void RenderBeginHyperlink (System.Web.UI.HtmlTextWriter writer, string targetUrl, bool encodeUrl, string softkeyLabel, string accessKey);

abstract member RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string * string -> unit
override this.RenderBeginHyperlink : System.Web.UI.HtmlTextWriter * string * bool * string * string -> unit

Public Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String, accessKey As String)

Parameter

writer: HtmlTextWriter

Der HtmlTextWriter, der Methoden für das Rendering der zielspezifischen Ausgabe enthält.

targetUrl: String

Der String-Wert mit der Ziel-URL des Links.

encodeUrl: Boolean

true, um den Ausgabestream mit HtmlAttributeEncode(String) zu codieren, andernfalls false.

softkeyLabel: String

Der String-Wert, der als Beschriftung einer Bildschirmtaste verwendet werden soll.

accessKey: String

Der dem accessKey-Attribut des zu erstellenden Links zuzuweisende String-Wert.

Ausnahmen

ArgumentOutOfRangeException

accessKey ist länger als 1 Zeichen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse mit dem Namen CustomPageAdapter der PageAdapter Klasse abgeleitet wird und die RenderBeginHyperlink Methode außer Kraft setzen kann. RenderBeginHyperlink fügt einem Hyperlink ein Attribut src hinzu, das einen Verweis auf die aktuelle Seite enthält. Alle Links, die in Seiten gerendert werden, an die angefügt wird, CustomPageAdapter weisen das src Attribut auf.

using System;
using System.IO;
using System.Web;
using System.Web.UI;
using System.Web.UI.Adapters;

// A derived PageAdapter class.
public class CustomPageAdapter : PageAdapter
{
    // Override RenderBeginHyperlink to add an attribute that 
    // references the referring page.
    public override void RenderBeginHyperlink(
        HtmlTextWriter writer, string targetUrl,
        bool encodeUrl, string softkeyLabel, 
        string accessKey )
    {
        string url = null;

        // Add the src attribute, if referring page URL is available.
        if( Page != null && Page.Request != null &&
            Page.Request.Url != null )
        {
            url = Page.Request.Url.AbsoluteUri;
            if( encodeUrl )
                url = HttpUtility.HtmlAttributeEncode( url );
            writer.AddAttribute( "src", url );
        }

        // Add the accessKey attribute, if caller requested.
        if( accessKey != null && accessKey.Length == 1 )
            writer.AddAttribute( "accessKey", accessKey );

        // Add the href attribute, encode the URL if requested.
        if( encodeUrl )
            url = HttpUtility.HtmlAttributeEncode( targetUrl );
        else
            url = targetUrl;
        writer.AddAttribute( "href", url );

        // Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag( "a" );
    }
}

Imports System.IO
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.Adapters

' A derived PageAdapter class.
Public Class CustomPageAdapter
    Inherits PageAdapter

    ' Override RenderBeginHyperlink to add an attribute that 
    ' references the referring page.
    Public Overrides Sub RenderBeginHyperlink( _
        ByVal writer As HtmlTextWriter, ByVal targetUrl As String, _
        ByVal encodeUrl As Boolean, ByVal softkeyLabel As String, _
        ByVal accessKey As String)

        Dim url As String

        ' Add the src attribute, if referring page URL is available.
        If Not (Page Is Nothing) Then
            If Not (Page.Request Is Nothing) Then
                If Not (Page.Request.Url Is Nothing) Then

                    url = Page.Request.Url.AbsoluteUri
                    If encodeUrl Then
                        url = HttpUtility.HtmlAttributeEncode(url)
                    End If
                    writer.AddAttribute("src", url)
                End If
            End If
        End If

        ' Render the accessKey attribute, if requested.
        If Not (accessKey Is Nothing) Then
            If accessKey.Length = 1 Then
                writer.AddAttribute("accessKey", accessKey)
            End If
        End If

        ' Add the href attribute, encode the URL if requested.
        If (encodeUrl) Then
            url = HttpUtility.HtmlAttributeEncode(targetUrl)
        Else
            url = targetUrl
        End If
        writer.AddAttribute("href", url)

        ' Render the hyperlink opening tag with the added attributes.
        writer.RenderBeginTag("a")

    End Sub
End Class

Hinweise

Die RenderBeginHyperlink Methode schreibt ein öffnender Hyperlinktag. Wenn writer es sich um ein HtmlTextWriter Objekt handelt, weist dieses Tag das folgende Format auf:

<a href=" targetUrl " accessKey=" accessKey ">

Hinweise für Vererber

Wenn Sie von der PageAdapter Klasse erben, können Sie die RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) Methode außer Kraft setzen, um ein anderes Format für ein öffnende Linktag zu schreiben oder zusätzliche Tagattribute zu schreiben. Die Basismethode schreibt z. B RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) . kein Attribut für softkeyLabel.

Siehe auch

Gilt für

Freigeben über

PageAdapter.RenderBeginHyperlink Methode

Definition

Überlädt

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Parameter

Beispiele

Hinweise

Hinweise für Vererber

Siehe auch

Gilt für

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Hinweise für Vererber

Siehe auch

Gilt für

Zusätzliche Ressourcen