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. |
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.
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
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.
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.