Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo PageAdapter.RenderBeginHyperlink (HtmlTextWriter, String, Boolean, String)

 

Data di pubblicazione: ottobre 2016

Esegue il rendering di un'apertura tag del collegamento ipertestuale che include l'URL di destinazione per il flusso di risposta.

Spazio dei nomi:   System.Web.UI.Adapters
Assembly:  System.Web (in System.Web.dll)

public virtual void RenderBeginHyperlink(
	HtmlTextWriter writer,
	string targetUrl,
	bool encodeUrl,
	string softkeyLabel
)

Parametri

writer
Type: System.Web.UI.HtmlTextWriter

Il HtmlTextWriter contenente i metodi per il rendering dell'output specifico della destinazione.

targetUrl
Type: System.String

Il String valore contenente l'URL di destinazione del collegamento.

encodeUrl
Type: System.Boolean

true Utilizzare HtmlAttributeEncode per codificare il flusso di output; in caso contrario, false.

softkeyLabel
Type: System.String

Il String valore da utilizzare come etichetta di un tasto softkey.

Il RenderBeginHyperlink metodo scrive un tag tag del collegamento ipertestuale. Quando writer è HtmlTextWriter, questo tag ha il seguente formato:

<a href="targetUrl">

Note per gli eredi:

Quando si eredita dalla PageAdapter classe, è possibile eseguire l'override di RenderBeginHyperlink metodo per scrivere un formato diverso per l'apertura di un collegamento ipertestuale tag o scrivere il tag di altro attributi. Ad esempio, il RenderBeginHyperlink metodo di base non scrive un attributo per softkeyLabel.

Esempio di codice riportato di seguito viene illustrato come derivare una classe denominata CustomPageAdapter dalla PageAdapter classe ed eseguire l'override di RenderBeginHyperlink metodo. Il RenderBeginHyperlink metodo aggiunge un attributo denominato src in un collegamento ipertestuale, che contiene un riferimento alla pagina corrente. Tutti i collegamenti ipertestuali viene eseguito il rendering in pagine a cui CustomPageAdapter è collegato avrà il src attributo.

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" );
    }
}

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: