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 HtmlTextWriter.AddAttribute (String, String, Boolean)

 

Data di pubblicazione: ottobre 2016

Aggiunge l'attributo del tag specificato e il valore al tag di apertura dell'elemento che la HtmlTextWriter oggetto creato con una chiamata successiva al RenderBeginTag (metodo), con codifica aggiuntiva.

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

public virtual void AddAttribute(
	string name,
	string value,
	bool fEndode
)

Parametri

name
Type: System.String

Stringa contenente il nome dell'attributo da aggiungere.

value
Type: System.String

Stringa contenente il valore da assegnare all'attributo.

fEndode
Type: System.Boolean

true per codificare l'attributo e il relativo valore; in caso contrario, false.

Utilizzare il AddAttribute Overload dei metodi di AddAttribute(String, String, Boolean) metodo se l'attributo non è uno del HtmlTextWriterAttribute valori o se l'attributo non è noto fino alla fase di esecuzione e la codifica è necessaria.

Per un'istanza di qualsiasi elemento di markup dato, la HtmlTextWriter classe gestisce un elenco di attributi per tale elemento. Quando il RenderBeginTag metodo viene chiamato, tutti gli attributi aggiunti dal AddAttribute metodo vengono sottoposti a rendering nel tag di apertura dell'elemento. L'elenco di attributi viene quindi cancellato il HtmlTextWriter oggetto.

Utilizzare il AddAttribute(String, String, Boolean) metodo con fEncode impostato su true, se l'attributo può contenere un segno di virgolette ("), un segno di minore (<), o una e commerciale (&). La chiamata al metodo verrà codificare l'attributo per soddisfare i requisiti del dispositivo richiedente. È possibile impostare fEncode a false, se è noto che nessuno di questi caratteri verrà generato o se si sa che l'attributo è già codificato.

Il modello di codifica per il rendering degli elementi di markup è come segue:

  • Utilizzare il AddAttribute metodo per aggiungere attributi all'elemento.

  • Usare il metodo RenderBeginTag.

  • Utilizzare altri metodi necessari per il rendering del contenuto tra l'elemento tag di apertura e chiusura.

  • Usare il metodo RenderEndTag.

Esempio di codice seguente viene illustrato come utilizzare il AddAttribute Overload dei metodi di AddAttribute(String, String, Boolean) metodo per assicurarsi che un attributo personalizzato, denominato myattribute, e il relativo valore non sono codificati per un <img> elemento.

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No &quot;encoding &quot; required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

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