PageAdapter.RenderBeginHyperlink Metod

Definition

Namnområde:: System.Web.UI.Adapters

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Renderar en inledande hyperlänktagg till svarsströmmen.

Överlagringar

Name	Description
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)	Renderar en inledande hyperlänktagg som innehåller mål-URL:en till svarsströmmen.
RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String)	Renderar en inledande hyperlänktagg som innehåller mål-URL:en och en åtkomstnyckel till svarsströmmen.

RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String)

Renderar en inledande hyperlänktagg som innehåller mål-URL:en till svarsströmmen.

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)

Parametrar

writer: HtmlTextWriter

De HtmlTextWriter metoder som innehåller för att återge målspecifika utdata.

targetUrl: String

Värdet String som innehåller länkens mål-URL.

encodeUrl: Boolean

trueatt använda HtmlAttributeEncode(String) för att koda strömmens utdata, annars . false

softkeyLabel: String

Värdet String som ska användas som en mjuk nyckeletikett.

Exempel

Följande kodexempel visar hur du härleder en klass med namnet CustomPageAdapter från PageAdapter klassen och åsidosätter RenderBeginHyperlink metoden. Metoden RenderBeginHyperlink lägger till ett attribut med namnet src till en hyperlänk som innehåller en referens till den aktuella sidan. Alla hyperlänkar som återges på sidor som CustomPageAdapter är kopplade till har attributet 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

Kommentarer

Metoden RenderBeginHyperlink skriver en inledande hyperlänktagg. När writer är HtmlTextWriterhar den här taggen följande format:

<a href=" targetUrl ">

Anteckningar till arvingar

När du ärver från PageAdapter klassen kan du åsidosätta RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) metoden för att skriva ett annat format för en inledande hyperlänktagg eller skriva ytterligare taggattribut. Basmetoden skriver till exempel RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String) inte ett attribut för softkeyLabel.

Se även

Gäller för

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

Renderar en inledande hyperlänktagg som innehåller mål-URL:en och en åtkomstnyckel till svarsströmmen.

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)

Parametrar

writer: HtmlTextWriter

De HtmlTextWriter metoder som innehåller för att återge målspecifika utdata.

targetUrl: String

Värdet String som innehåller länkens mål-URL.

encodeUrl: Boolean

trueatt använda HtmlAttributeEncode(String) för att koda strömmens utdata, annars . false

softkeyLabel: String

Värdet String som ska användas som en mjuk nyckeletikett.

accessKey: String

Värdet String som ska tilldelas till accessKey attributet för länken som ska skapas.

Undantag

ArgumentOutOfRangeException

accessKey är längre än ett tecken.

Exempel

Följande kodexempel visar hur du härleder en klass med namnet CustomPageAdapter från PageAdapter klassen och åsidosätter RenderBeginHyperlink metoden. RenderBeginHyperlink lägger till ett attribut med namnet src till en hyperlänk som innehåller en referens till den aktuella sidan. Alla hyperlänkar som återges på sidor som CustomPageAdapter är kopplade till har attributet 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

Kommentarer

Metoden RenderBeginHyperlink skriver en inledande hyperlänktagg. När writer är ett HtmlTextWriter objekt har den här taggen följande format:

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

Anteckningar till arvingar

När du ärver från PageAdapter klassen kan du åsidosätta RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) metoden för att skriva ett annat format för en inledande hyperlänktagg eller skriva ytterligare taggattribut. Basmetoden skriver till exempel RenderBeginHyperlink(HtmlTextWriter, String, Boolean, String, String) inte ett attribut för softkeyLabel.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?