PageAdapter.RenderBeginHyperlink Methode

Definitie

Naamruimte:: System.Web.UI.Adapters

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Geeft een hyperlinktag openen weer voor de antwoordstroom.

Overloads

Name	Description
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Hiermee wordt een hyperlinktag voor openen weergegeven die de doel-URL naar de antwoordstroom bevat.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Geeft een openingshyperlinktag weer die de doel-URL en een toegangssleutel voor de antwoordstroom bevat.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Hiermee wordt een hyperlinktag voor openen weergegeven die de doel-URL naar de antwoordstroom bevat.

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)

Parameters

writer: HtmlTextWriter

De HtmlTextWriter bevat methoden om de doelspecifieke uitvoer weer te geven.

targetUrl: String

De String waarde die de doel-URL van de koppeling bevat.

encodeUrl: Boolean

true te gebruiken HtmlAttributeEncode(String) om de stroomuitvoer te coderen; falseanders.

softkeyLabel: String

De String waarde die moet worden gebruikt als een label voor zachte sleutels.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een klasse kunt afleiden die is benoemd CustomPageAdapter uit de PageAdapter klasse en hoe u de RenderBeginHyperlink methode overschrijft. Met RenderBeginHyperlink de methode wordt een kenmerk met de naam src toegevoegd aan een hyperlink, dat een verwijzing naar de huidige pagina bevat. Alle hyperlinks die worden weergegeven op pagina's waaraan CustomPageAdapter is gekoppeld, hebben het src kenmerk.

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

Opmerkingen

Met de RenderBeginHyperlink methode wordt een hyperlinktag voor openen geschreven. Wanneer writer is HtmlTextWriter, heeft deze tag de volgende indeling:

<a href=" targetUrl ">

Notities voor overnemers

Wanneer u de klasse overschrijft PageAdapter , kunt u de RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) methode overschrijven om een andere indeling te schrijven voor een hyperlinktag openen of om extra tagkenmerken te schrijven. De basismethode schrijft bijvoorbeeld RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) geen kenmerk voor softkeyLabel.

Zie ook

Van toepassing op

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

Geeft een openingshyperlinktag weer die de doel-URL en een toegangssleutel voor de antwoordstroom bevat.

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)

Parameters

writer: HtmlTextWriter

De HtmlTextWriter bevat methoden om de doelspecifieke uitvoer weer te geven.

targetUrl: String

De String waarde die de doel-URL van de koppeling bevat.

encodeUrl: Boolean

true te gebruiken HtmlAttributeEncode(String) om de stroomuitvoer te coderen; falseanders.

softkeyLabel: String

De String waarde die moet worden gebruikt als een label voor zachte sleutels.

accessKey: String

De String waarde die moet worden toegewezen aan het accessKey kenmerk van de koppeling die moet worden gemaakt.

Uitzonderingen

ArgumentOutOfRangeException

accessKey is langer dan één teken.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een klasse kunt afleiden die is benoemd CustomPageAdapter uit de PageAdapter klasse en hoe u de RenderBeginHyperlink methode overschrijft. RenderBeginHyperlink voegt een kenmerk met de naam src toe aan een hyperlink, dat een verwijzing naar de huidige pagina bevat. Alle hyperlinks die worden weergegeven op pagina's waaraan CustomPageAdapter is gekoppeld, hebben het src kenmerk.

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

Opmerkingen

Met de RenderBeginHyperlink methode wordt een hyperlinktag voor openen geschreven. Wanneer writer een object is HtmlTextWriter , heeft deze tag de volgende indeling:

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

Notities voor overnemers

Wanneer u de klasse overschrijft PageAdapter , kunt u de RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) methode overschrijven om een andere indeling te schrijven voor een hyperlinktag openen of om extra tagkenmerken te schrijven. De basismethode schrijft bijvoorbeeld RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) geen kenmerk voor softkeyLabel.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?