PageAdapter.RenderBeginHyperlink Metode

Referensi

Definisi

Ruang nama:: System.Web.UI.Adapters

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Merender tag hyperlink pembuka ke aliran respons.

Overload

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Merender tag hyperlink pembuka yang menyertakan URL target ke aliran respons.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Merender tag hyperlink pembuka yang menyertakan URL target dan kunci akses ke aliran respons.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Merender tag hyperlink pembuka yang menyertakan URL target ke aliran respons.

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

HtmlTextWriter berisi metode untuk merender output khusus target.

targetUrl: String

Nilai String yang menyimpan URL target tautan.

encodeUrl: Boolean

true menggunakan HtmlAttributeEncode(String) untuk mengodekan output aliran; jika tidak, false.

softkeyLabel: String

Nilai String untuk digunakan sebagai label kunci lunak.

Contoh

Contoh kode berikut menunjukkan cara mendapatkan kelas bernama CustomPageAdapter dari kelas PageAdapter dan mengambil alih metode RenderBeginHyperlink. Metode RenderBeginHyperlink menambahkan atribut bernama src ke hyperlink, yang berisi referensi ke halaman saat ini. Semua hyperlink yang dirender di halaman tempat CustomPageAdapter dilampirkan akan memiliki atribut 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

Keterangan

Metode RenderBeginHyperlink menulis tag hyperlink pembuka. Saat writerHtmlTextWriter, tag ini memiliki format berikut:

<a href=" targetUrl ">

Catatan Bagi Inheritor

Saat mewarisi dari kelas PageAdapter, Anda dapat mengambil alih metode RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) untuk menulis format yang berbeda untuk tag hyperlink pembuka atau menulis atribut tag tambahan. Misalnya, metode dasar RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) tidak menulis atribut untuk softkeyLabel.

Lihat juga

Berlaku untuk

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

Merender tag hyperlink pembuka yang menyertakan URL target dan kunci akses ke aliran respons.

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

HtmlTextWriter berisi metode untuk merender output khusus target.

targetUrl: String

Nilai String yang menyimpan URL target tautan.

encodeUrl: Boolean

true menggunakan HtmlAttributeEncode(String) untuk mengodekan output aliran; jika tidak, false.

softkeyLabel: String

Nilai String untuk digunakan sebagai label kunci lunak.

accessKey: String

Nilai String untuk ditetapkan ke atribut accessKey tautan untuk dibuat.

Pengecualian

ArgumentOutOfRangeException

accessKey lebih panjang dari satu karakter.

Contoh

Contoh kode berikut menunjukkan cara mendapatkan kelas bernama CustomPageAdapter dari kelas PageAdapter dan mengambil alih metode RenderBeginHyperlink. RenderBeginHyperlink menambahkan atribut bernama src ke hyperlink, yang berisi referensi ke halaman saat ini. Semua hyperlink yang dirender di halaman tempat CustomPageAdapter dilampirkan akan memiliki atribut 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

Keterangan

Metode RenderBeginHyperlink menulis tag hyperlink pembuka. Ketika writer adalah objek HtmlTextWriter, tag ini memiliki format berikut:

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

Catatan Bagi Inheritor

Saat mewarisi dari kelas PageAdapter, Anda dapat mengambil alih metode RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) untuk menulis format yang berbeda untuk tag hyperlink pembuka atau menulis atribut tag tambahan. Misalnya, metode dasar RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) tidak menulis atribut untuk softkeyLabel.

Lihat juga

Berlaku untuk

Bagikan melalui

PageAdapter.RenderBeginHyperlink Metode

Definisi

Overload

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Parameter

Contoh

Keterangan

Catatan Bagi Inheritor

Lihat juga

Berlaku untuk

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)

Parameter

Pengecualian

Contoh

Keterangan

Catatan Bagi Inheritor

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: