PageAdapter.RenderBeginHyperlink Yöntem

Tanım

Ad Alanı:: System.Web.UI.Adapters

Bütünleştirilmiş Kod:: System.Web.dll

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

Aşırı Yüklemeler

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

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

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

Public Overridable Sub RenderBeginHyperlink (writer As HtmlTextWriter, targetUrl As String, encodeUrl As Boolean, softkeyLabel As String)

Parametreler

writer: HtmlTextWriter

Hedefe HtmlTextWriter özgü çıkışı işlemek için içeren yöntemler.

targetUrl: String

Bağlantının String hedef URL'sini tutan değer.

encodeUrl: Boolean

true kullanarak akış çıkışını kodlamak için kullanın HtmlAttributeEncode(String) ; aksi takdirde , false.

softkeyLabel: String

Yumuşak String anahtar etiketi olarak kullanılacak değer.

Örnekler

Aşağıdaki kod örneği, sınıfından CustomPageAdapter adlı PageAdapter bir sınıfın nasıl türetilip yönteminin nasıl geçersiz kılınduğunu RenderBeginHyperlink gösterir. RenderBeginHyperlink yöntemi, geçerli sayfaya başvuru içeren köprüye adlı src bir öznitelik ekler. Ekli olan sayfalarda CustomPageAdapter işlenen tüm köprüler özniteliğine src 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. olduğunda writerHtmlTextWriter, bu etiket aşağıdaki biçime sahiptir:

<a href=" targetUrl ">

Devralanlara Notlar

sınıfından PageAdapter devraldığınızda, açma köprü etiketi için farklı bir biçim yazmak veya ek etiket öznitelikleri yazmak için yöntemini geçersiz kılabilirsiniz RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) . Örneğin, RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) temel yöntem için softkeyLabelbir öznitelik yazmaz.

Ayrıca bkz.

Şunlara uygulanır

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.

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)

Parametreler

writer: HtmlTextWriter

Hedefe HtmlTextWriter özgü çıkışı işlemek için içeren yöntemler.

targetUrl: String

Bağlantının String hedef URL'sini tutan değer.

encodeUrl: Boolean

true kullanarak akış çıkışını kodlamak için kullanın HtmlAttributeEncode(String) ; aksi takdirde , false.

softkeyLabel: String

Yumuşak String anahtar etiketi olarak kullanılacak değer.

accessKey: String

String Oluşturulacak bağlantının accessKey özniteliğine atanacak değer.

Özel durumlar

ArgumentOutOfRangeException

accessKey bir karakterden uzundur.

Örnekler

Aşağıdaki kod örneği, sınıfından CustomPageAdapter adlı PageAdapter bir sınıfın nasıl türetilip yönteminin nasıl geçersiz kılınduğunu RenderBeginHyperlink gösterir. RenderBeginHyperlink , geçerli sayfaya başvuru içeren köprüye adlı src bir öznitelik ekler. Ekli olan sayfalarda CustomPageAdapter işlenen tüm köprüler özniteliğine src 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. Bir writer nesne olduğundaHtmlTextWriter, bu etiket aşağıdaki biçime sahiptir:

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

Devralanlara Notlar

sınıfından PageAdapter devraldığınızda, açma köprü etiketi için farklı bir biçim yazmak veya ek etiket öznitelikleri yazmak için yöntemini geçersiz kılabilirsiniz RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) . Örneğin, RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) temel yöntem için softkeyLabelbir öznitelik yazmaz.

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?