PageAdapter.RenderBeginHyperlink Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.Adapters

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Renderuje otwierający tag hiperłącza do strumienia odpowiedzi.

Przeciążenia

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Renderuje otwierający tag hiperłącza, który zawiera docelowy adres URL strumienia odpowiedzi.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Renderuje otwierający tag hiperłącza zawierający docelowy adres URL i klucz dostępu do strumienia odpowiedzi.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Renderuje otwierający tag hiperłącza, który zawiera docelowy adres URL strumienia odpowiedzi.

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)

Parametry

writer: HtmlTextWriter

HtmlTextWriter zawierające metody renderowania danych wyjściowych specyficznych dla obiektu docelowego.

targetUrl: String

Wartość String zawierająca docelowy adres URL linku.

encodeUrl: Boolean

true użyć HtmlAttributeEncode(String) do zakodowania danych wyjściowych strumienia; w przeciwnym razie false.

softkeyLabel: String

Wartość String używana jako etykieta klucza miękkiego.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć klasę o nazwie CustomPageAdapter z klasy PageAdapter i zastąpić metodę RenderBeginHyperlink. Metoda RenderBeginHyperlink dodaje atrybut o nazwie src do hiperłącza, który zawiera odwołanie do bieżącej strony. Wszystkie hiperlinki renderowane na stronach, do których dołączono CustomPageAdapter, będą miały atrybut src.

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

Uwagi

Metoda RenderBeginHyperlink zapisuje tag otwierający hiperłącze. Gdy writer jest HtmlTextWriter, ten tag ma następujący format:

<a href=" targetUrl ">

Uwagi dotyczące dziedziczenia

Po dziedziczeniu z klasy PageAdapter można zastąpić metodę RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String), aby napisać inny format dla otwierającego tagu hiperłącza lub zapisać dodatkowe atrybuty tagu. Na przykład metoda podstawowa RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) nie zapisuje atrybutu dla softkeyLabel.

Zobacz też

Dotyczy

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

Renderuje otwierający tag hiperłącza zawierający docelowy adres URL i klucz dostępu do strumienia odpowiedzi.

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)

Parametry

writer: HtmlTextWriter

HtmlTextWriter zawierające metody renderowania danych wyjściowych specyficznych dla obiektu docelowego.

targetUrl: String

Wartość String zawierająca docelowy adres URL linku.

encodeUrl: Boolean

true użyć HtmlAttributeEncode(String) do zakodowania danych wyjściowych strumienia; w przeciwnym razie false.

softkeyLabel: String

Wartość String używana jako etykieta klucza miękkiego.

accessKey: String

Wartość String, która ma zostać przypisana do atrybutu accessKey linku do utworzenia.

Wyjątki

ArgumentOutOfRangeException

accessKey jest dłuższy niż jeden znak.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć klasę o nazwie CustomPageAdapter z klasy PageAdapter i zastąpić metodę RenderBeginHyperlink. RenderBeginHyperlink dodaje atrybut o nazwie src do hiperłącza, który zawiera odwołanie do bieżącej strony. Wszystkie hiperlinki renderowane na stronach, do których dołączono CustomPageAdapter, będą miały atrybut src.

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

Uwagi

Metoda RenderBeginHyperlink zapisuje tag otwierający hiperłącze. Gdy writer jest obiektem HtmlTextWriter, ten tag ma następujący format:

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

Uwagi dotyczące dziedziczenia

Po dziedziczeniu z klasy PageAdapter można zastąpić metodę RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String), aby napisać inny format dla otwierającego tagu hiperłącza lub zapisać dodatkowe atrybuty tagu. Na przykład metoda podstawowa RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) nie zapisuje atrybutu dla softkeyLabel.

Zobacz też

Dotyczy

Udostępnij za pośrednictwem

PageAdapter.RenderBeginHyperlink Metoda

Definicja

Przeciążenia

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Parametry

Przykłady

Uwagi

Uwagi dotyczące dziedziczenia

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Uwagi dotyczące dziedziczenia

Zobacz też

Dotyczy

Dodatkowe zasoby