PageAdapter.RenderBeginHyperlink Methode
Definition
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.
Rendert ein öffnende Hyperlinktag im Antwortdatenstrom.
Überlädt
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) |
Rendert ein öffnende Hyperlinktag, das die Ziel-URL zum Antwortdatenstrom enthält. |
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) |
Rendert ein öffnende Hyperlinktag, das die Ziel-URL und einen Zugriffsschlüssel für den Antwortdatenstrom enthält. |
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)
Rendert ein öffnende Hyperlinktag, das die Ziel-URL zum Antwortdatenstrom enthält.
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
Die HtmlTextWriter, die Methoden zum Rendern der zielspezifischen Ausgabe enthalten.
- encodeUrl
- Boolean
true
zum Codieren der Datenstromausgabe HtmlAttributeEncode(String); andernfalls false
.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie eine Klasse mit dem Namen CustomPageAdapter
von der PageAdapter Klasse ableiten und die RenderBeginHyperlink-Methode außer Kraft setzen. Die RenderBeginHyperlink-Methode fügt einem Link ein Attribut namens src
hinzu, das einen Verweis auf die aktuelle Seite enthält. Alle Links, die in Seiten gerendert werden, an die CustomPageAdapter
angefügt ist, weisen das attribut src
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 öffnende Hyperlinktag. Wenn writer
HtmlTextWriterist, 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 Hyperlinktag zu schreiben oder zusätzliche Tagattribute zu schreiben. Die RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) Basismethode schreibt z. B. kein Attribut für softkeyLabel
.
Weitere Informationen
Gilt für:
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)
Rendert ein öffnende Hyperlinktag, das die Ziel-URL und einen Zugriffsschlüssel für den Antwortdatenstrom enthält.
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
Die HtmlTextWriter, die Methoden zum Rendern der zielspezifischen Ausgabe enthalten.
- encodeUrl
- Boolean
true
zum Codieren der Datenstromausgabe HtmlAttributeEncode(String); andernfalls false
.
- accessKey
- String
Der String Wert, der dem accessKey
Attribut des zu erstellenden Links zugewiesen werden soll.
Ausnahmen
accessKey
ist länger als ein Zeichen.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie eine Klasse mit dem Namen CustomPageAdapter
von der PageAdapter Klasse ableiten und die RenderBeginHyperlink-Methode außer Kraft setzen.
RenderBeginHyperlink fügt einem Link ein Attribut namens src
hinzu, das einen Verweis auf die aktuelle Seite enthält. Alle Links, die in Seiten gerendert werden, an die CustomPageAdapter
angefügt ist, weisen das attribut src
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 öffnende Hyperlinktag. Wenn writer
ein HtmlTextWriter-Objekt ist, 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 Hyperlinktag zu schreiben oder zusätzliche Tagattribute zu schreiben. Die RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) Basismethode schreibt z. B. kein Attribut für softkeyLabel
.