PageAdapter.RenderBeginHyperlink Método

Definição

Renderiza uma marcação de hiperlink de abertura para o fluxo de resposta.Renders an opening hyperlink tag to the response stream.

Sobrecargas

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Renderiza uma marcação de hiperlink de abertura que inclui a URL de destino para o fluxo de resposta.Renders an opening hyperlink tag that includes the target URL to the response stream.

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

Renderiza uma marcação de hiperlink de abertura que inclui a URL de destino e uma chave de acesso para o fluxo de resposta.Renders an opening hyperlink tag that includes the target URL and an access key to the response stream.

Renderiza uma marcação de hiperlink de abertura que inclui a URL de destino para o fluxo de resposta.Renders an opening hyperlink tag that includes the target URL to the response stream.

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)

Parâmetros

writer
HtmlTextWriter

O HtmlTextWriter que contém os métodos para renderizar a saída específica do destino.The HtmlTextWriter containing methods to render the target-specific output.

targetUrl
String

O valor String que contém a URL de destino do link.The String value holding the target URL of the link.

encodeUrl
Boolean

true para usar HtmlAttributeEncode(String) para codificar o fluxo de saída; caso contrário, false.true to use HtmlAttributeEncode(String) to encode the stream output; otherwise, false.

softkeyLabel
String

O valor String a ser usado como um rótulo de tecla.The String value to use as a soft key label.

Exemplos

O exemplo de código a seguir demonstra como derivar uma classe chamada CustomPageAdapter da PageAdapter classe e substituir o RenderBeginHyperlink método.The following code example demonstrates how to derive a class named CustomPageAdapter from the PageAdapter class and override the RenderBeginHyperlink method. O RenderBeginHyperlink método adiciona um atributo chamado src a um hiperlink, que contém uma referência à página atual.The RenderBeginHyperlink method adds an attribute named src to a hyperlink, which contains a reference to the current page. Todos os hiperlinks renderizados em páginas às quais CustomPageAdapter o está anexado terão o src atributo.All hyperlinks rendered in pages to which CustomPageAdapter is attached will have the src attribute.

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

Comentários

O RenderBeginHyperlink método grava uma marca de hiperlink de abertura.The RenderBeginHyperlink method writes an opening hyperlink tag. Quando writer é HtmlTextWriter , essa marca tem o seguinte formato:When writer is HtmlTextWriter, this tag has the following format:

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

Notas aos Herdeiros

Ao herdar da PageAdapter classe, você pode substituir o RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) método para gravar um formato diferente para uma marca de hiperlink de abertura ou para escrever atributos de marca adicionais.When you inherit from the PageAdapter class, you can override the RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) method to write a different format for an opening hyperlink tag or to write additional tag attributes. Por exemplo, o RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) método base não grava um atributo para softkeyLabel .For example, the RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) base method does not write an attribute for softkeyLabel.

Confira também

Aplica-se a

Renderiza uma marcação de hiperlink de abertura que inclui a URL de destino e uma chave de acesso para o fluxo de resposta.Renders an opening hyperlink tag that includes the target URL and an access key to the response stream.

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)

Parâmetros

writer
HtmlTextWriter

O HtmlTextWriter que contém os métodos para renderizar a saída específica do destino.The HtmlTextWriter containing methods to render the target-specific output.

targetUrl
String

O valor String que contém a URL de destino do link.The String value holding the target URL of the link.

encodeUrl
Boolean

true para usar HtmlAttributeEncode(String) para codificar o fluxo de saída; caso contrário, false.true to use HtmlAttributeEncode(String) to encode the stream output; otherwise, false.

softkeyLabel
String

O valor String a ser usado como um rótulo de tecla.The String value to use as a soft key label.

accessKey
String

O valor String a ser atribuído ao atributo accessKey do link a ser criado.The String value to assign to the accessKey attribute of the link to create.

Exceções

accessKey é maior que um caractere.accessKey is longer than one character.

Exemplos

O exemplo de código a seguir demonstra como derivar uma classe chamada CustomPageAdapter da PageAdapter classe e substituir o RenderBeginHyperlink método.The following code example demonstrates how to derive a class named CustomPageAdapter from the PageAdapter class and override the RenderBeginHyperlink method. RenderBeginHyperlink Adiciona um atributo chamado src a um hiperlink, que contém uma referência à página atual.RenderBeginHyperlink adds an attribute named src to a hyperlink, which contains a reference to the current page. Todos os hiperlinks renderizados em páginas às quais CustomPageAdapter o está anexado terão o src atributo.All hyperlinks rendered in pages to which CustomPageAdapter is attached will have the src attribute.

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

Comentários

O RenderBeginHyperlink método grava uma marca de hiperlink de abertura.The RenderBeginHyperlink method writes an opening hyperlink tag. Quando writer é um HtmlTextWriter objeto, essa marca tem o seguinte formato:When writer is an HtmlTextWriter object, this tag has the following format:

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

Notas aos Herdeiros

Ao herdar da PageAdapter classe, você pode substituir o RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) método para gravar um formato diferente para uma marca de hiperlink de abertura ou para escrever atributos de marca adicionais.When you inherit from the PageAdapter class, you can override the RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) method to write a different format for an opening hyperlink tag or to write additional tag attributes. Por exemplo, o RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) método base não grava um atributo para softkeyLabel .For example, the RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) base method does not write an attribute for softkeyLabel.

Confira também

Aplica-se a