PageAdapter.RenderBeginHyperlink Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Подготавливает к просмотру открывающий тэг гиперссылки для ответного потока.
Перегрузки
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) |
Подготавливает к просмотру открывающий тэг гиперссылки, который включает конечный URL-адрес для ответного потока. |
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) |
Подготавливает к просмотру открывающий тэг гиперссылки, который включает конечный URL-адрес и код доступа к ответному потоку. |
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)
Подготавливает к просмотру открывающий тэг гиперссылки, который включает конечный URL-адрес для ответного потока.
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)
Параметры
- writer
- HtmlTextWriter
Объект HtmlTextWriter, содержащий методы отрисовки целевого вывода.
- encodeUrl
- Boolean
Объект true
использующий метод HtmlAttributeEncode(String) кодирования выходного потока; в противном случае — false
.
Примеры
В следующем примере кода показано, как наследовать класс с именем CustomPageAdapter
из PageAdapter класса и переопределить RenderBeginHyperlink метод . Метод RenderBeginHyperlink добавляет атрибут с именем src
в гиперссылку, которая содержит ссылку на текущую страницу. Все гиперссылки, отображаемые на страницах, к которым CustomPageAdapter
присоединен, будут иметь 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
Комментарии
Метод RenderBeginHyperlink записывает открывающий тег гиперссылки. Если writer
имеет значение HtmlTextWriter, этот тег имеет следующий формат:
<a href="
targetUrl
">
Примечания для тех, кто наследует этот метод
При наследовании от PageAdapter класса можно переопределить RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) метод для записи другого формата для открывающего тега гиперссылки или для записи дополнительных атрибутов тега. Например, базовый RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) метод не записывает атрибут для softkeyLabel
.
См. также раздел
Применяется к
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)
Подготавливает к просмотру открывающий тэг гиперссылки, который включает конечный URL-адрес и код доступа к ответному потоку.
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)
Параметры
- writer
- HtmlTextWriter
Объект HtmlTextWriter, содержащий методы отрисовки целевого вывода.
- encodeUrl
- Boolean
Объект true
использующий метод HtmlAttributeEncode(String) кодирования выходного потока; в противном случае — false
.
Исключения
Имя атрибута accessKey
длиннее одного символа.
Примеры
В следующем примере кода показано, как наследовать класс с именем CustomPageAdapter
из PageAdapter класса и переопределить RenderBeginHyperlink метод . RenderBeginHyperlink добавляет атрибут с именем src
в гиперссылку, которая содержит ссылку на текущую страницу. Все гиперссылки, отображаемые на страницах, к которым CustomPageAdapter
присоединен, будут иметь 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
Комментарии
Метод RenderBeginHyperlink записывает открывающий тег гиперссылки. Если writer
является HtmlTextWriter объектом , этот тег имеет следующий формат:
<a href="
targetUrl
" accessKey="
accessKey
">
Примечания для тех, кто наследует этот метод
При наследовании от PageAdapter класса можно переопределить RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) метод для записи другого формата для открывающего тега гиперссылки или для записи дополнительных атрибутов тега. Например, базовый RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) метод не записывает атрибут для softkeyLabel
.
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по