PageAdapter.RenderBeginHyperlink Yöntem
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Yanıt akışına açılan köprü etiketini işler.
| RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) |
Yanıt akışının hedef URL'sini içeren bir açılış köprü etiketi oluşturur. |
| RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) |
Hedef URL'yi ve yanıt akışına erişim anahtarını içeren bir açılış köprü etiketi oluşturur. |
Yanıt akışının hedef URL'sini içeren bir açılış köprü etiketi oluşturur.
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 -> unitPublic Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String)Parametreler
- writer
- HtmlTextWriter
Hedefe özgü çıkışı işlemek için yöntemleri içeren HtmlTextWriter.
- encodeUrl
- Boolean
akış çıkışını kodlamak için HtmlAttributeEncode(String) kullanmak true; aksi takdirde, false.
Örnekler
Aşağıdaki kod örneği, PageAdapter sınıfından CustomPageAdapter adlı bir sınıfı türetmeyi ve RenderBeginHyperlink yöntemini geçersiz kılmayı gösterir.
RenderBeginHyperlink yöntemi, geçerli sayfaya başvuru içeren köprüye src adlı bir öznitelik ekler.
CustomPageAdapter eklendiği sayfalarda işlenen tüm köprüler src özniteliğine sahip olur.
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
Açıklamalar
RenderBeginHyperlink yöntemi bir açılış köprü etiketi yazar.
writer
HtmlTextWriterolduğunda, bu etiket aşağıdaki biçime sahiptir:
<a href="
targetUrl
">
Devralanlara Notlar
PageAdapter sınıfından devraldığınızda, açılış köprü etiketi için farklı bir biçim yazmak veya ek etiket öznitelikleri yazmak için RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) yöntemini geçersiz kılabilirsiniz. Örneğin, RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) temel yöntemi softkeyLabeliçin bir öznitelik yazmaz.
Ayrıca bkz.
Şunlara uygulanır
.NET Framework 4.8.1 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Hedef URL'yi ve yanıt akışına erişim anahtarını içeren bir açılış köprü etiketi oluşturur.
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 -> unitPublic Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String, accessKey As String)Parametreler
- writer
- HtmlTextWriter
Hedefe özgü çıkışı işlemek için yöntemleri içeren HtmlTextWriter.
- encodeUrl
- Boolean
akış çıkışını kodlamak için HtmlAttributeEncode(String) kullanmak true; aksi takdirde, false.
Özel durumlar
accessKey bir karakterden uzundur.
Örnekler
Aşağıdaki kod örneği, PageAdapter sınıfından CustomPageAdapter adlı bir sınıfı türetmeyi ve RenderBeginHyperlink yöntemini geçersiz kılmayı gösterir.
RenderBeginHyperlink köprüye geçerli sayfaya başvuru içeren src adlı bir öznitelik ekler.
CustomPageAdapter eklendiği sayfalarda işlenen tüm köprüler src özniteliğine sahip olur.
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
Açıklamalar
RenderBeginHyperlink yöntemi bir açılış köprü etiketi yazar.
writer bir HtmlTextWriter nesnesi olduğunda, bu etiket aşağıdaki biçime sahiptir:
<a href="
targetUrl
" accessKey="
accessKey
">
Devralanlara Notlar
PageAdapter sınıfından devraldığınızda, açılış köprü etiketi için farklı bir biçim yazmak veya ek etiket öznitelikleri yazmak için RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) yöntemini geçersiz kılabilirsiniz. Örneğin, RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) temel yöntemi softkeyLabeliçin bir öznitelik yazmaz.
Ayrıca bkz.
Şunlara uygulanır
.NET Framework 4.8.1 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET geri bildirimi
.NET, açık kaynak bir projedir. Geri bildirim sağlamak için bir bağlantı seçin: