HtmlTextWriter.AddAttribute Metodo

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Aggiunge l'attributo e il valore di markup specificati al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .

Overload

Nome	Descrizione
AddAttribute(String, String)	Aggiunge l'attributo e il valore di markup specificati al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .
AddAttribute(HtmlTextWriterAttribute, String)	Aggiunge l'attributo di markup e il valore dell'attributo al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .
AddAttribute(String, String, Boolean)	Aggiunge l'attributo e il valore di markup specificati al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo, con codifica facoltativa.
AddAttribute(String, String, HtmlTextWriterAttribute)	Aggiunge l'attributo e il valore di markup specificati, insieme a un HtmlTextWriterAttribute valore di enumerazione, al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Aggiunge l'attributo di markup e il valore dell'attributo al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo , con codifica facoltativa.

AddAttribute(String, String)

Aggiunge l'attributo e il valore di markup specificati al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute(string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Parametri

name: String

Stringa contenente il nome dell'attributo da aggiungere.

value: String

Stringa contenente il valore da assegnare all'attributo.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il AddAttribute metodo prima di chiamare il RenderBeginTag metodo . Il codice chiama due overload diversi di e due overload diversi di AddAttribute prima di AddStyleAttribute chiamare il metodo per eseguire il RenderBeginTag rendering di un <span> elemento nel flusso di output. Il AddAttribute(String, String) metodo viene usato per definire l'attributo personalizzato denominato CustomAttribute e il valore personalizzato denominato CustomAttributeValue per l'elemento di cui viene eseguito il <span> rendering.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Commenti

Utilizzare l'overload AddAttribute del AddAttribute(String, String) metodo se l'attributo non è uno dei HtmlTextWriterAttribute valori o se l'attributo non è noto fino al runtime.

Per un'istanza di un determinato elemento di markup, la HtmlTextWriter classe mantiene un elenco di attributi per tale elemento. Quando viene chiamato il RenderBeginTag metodo , viene eseguito il AddAttribute rendering di tutti gli attributi aggiunti dal metodo al tag di apertura dell'elemento . L'elenco di attributi viene quindi cancellato dall'oggetto HtmlTextWriter .

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

Utilizzare il AddAttribute metodo per aggiungere attributi all'elemento .
Usare il metodo RenderBeginTag.
Usare altri metodi in base alle esigenze per eseguire il rendering del contenuto trovato tra i tag di apertura e chiusura dell'elemento.
Usare il metodo RenderEndTag.

Vedi anche

Si applica a

AddAttribute(HtmlTextWriterAttribute, String)

Aggiunge l'attributo di markup e il valore dell'attributo al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Parametri

key: HtmlTextWriterAttribute

Oggetto HtmlTextWriterAttribute che rappresenta l'attributo di markup da aggiungere al flusso di output.

value: String

Stringa contenente il valore da assegnare all'attributo.

Esempio

Nell'esempio di codice seguente viene illustrato come usare l'overload AddAttribute del AddAttribute(HtmlTextWriterAttribute, String) metodo per aggiungere un Onclick attributo a un elemento di markup e quindi impostarne il valore sul codice ECMAScript seguente:

alert('Hello');

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Commenti

Usare l'overload del metodo per eseguire il AddAttribute AddAttribute(HtmlTextWriterAttribute, String) rendering di un attributo di markup standard.

Per un'istanza di un determinato elemento di markup, la HtmlTextWriter classe mantiene un elenco di attributi per tale elemento. Quando viene chiamato il RenderBeginTag metodo , viene eseguito il AddAttribute rendering di tutti gli attributi aggiunti dal metodo al tag di apertura dell'elemento. L'elenco di attributi viene quindi cancellato da HtmlTextWriter.

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

Utilizzare il AddAttribute metodo per aggiungere attributi all'elemento .
Usare il metodo RenderBeginTag.
Usare altri metodi in base alle esigenze per eseguire il rendering del contenuto trovato tra i tag di apertura e chiusura dell'elemento.
Usare il metodo RenderEndTag.

Vedi anche

Si applica a

AddAttribute(String, String, Boolean)

Aggiunge l'attributo e il valore di markup specificati al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo, con codifica facoltativa.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

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

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Parametri

name: String

Stringa contenente il nome dell'attributo da aggiungere.

value: String

Stringa contenente il valore da assegnare all'attributo.

fEndode: Boolean

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

Esempio

Nell'esempio di codice seguente viene illustrato come usare l'overload AddAttribute del AddAttribute(String, String, Boolean) metodo per assicurarsi che un attributo personalizzato, denominato myattributee il relativo valore non siano 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 "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

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

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Commenti

Usare l'overload AddAttribute del AddAttribute(String, String, Boolean) metodo se l'attributo non è uno dei HtmlTextWriterAttribute valori o se l'attributo non è noto fino a quando non è necessaria la fase di esecuzione e la codifica.

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

Se il tipo di attributo è Style, il valore non verrà codificato anche se fEndode è true. Assicurarsi che il valore di stile sia conforme a CSS e che non contenga codice dannoso.

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

Utilizzare il AddAttribute metodo per aggiungere attributi all'elemento .
Usare il metodo RenderBeginTag.
Usare altri metodi in base alle esigenze per eseguire il rendering del contenuto trovato tra i tag di apertura e chiusura dell'elemento.
Usare il metodo RenderEndTag.

Vedi anche

Si applica a

AddAttribute(String, String, HtmlTextWriterAttribute)

Aggiunge l'attributo e il valore di markup specificati, insieme a un HtmlTextWriterAttribute valore di enumerazione, al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo .

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute(string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Parametri

name: String

Stringa contenente il nome dell'attributo da aggiungere.

value: String

Stringa contenente il valore da assegnare all'attributo.

key: HtmlTextWriterAttribute

Oggetto HtmlTextWriterAttribute che rappresenta l'attributo .

Commenti

Usare l'overload AddAttribute del AddAttribute(String, String, HtmlTextWriterAttribute) metodo solo quando eredita dalla HtmlTextWriter classe . Consente di creare nuove name coppie e key per gli attributi.

Vedi anche

Si applica a

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Aggiunge l'attributo di markup e il valore dell'attributo al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al RenderBeginTag metodo , con codifica facoltativa.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Parametri

key: HtmlTextWriterAttribute

Oggetto HtmlTextWriterAttribute che rappresenta l'attributo di markup da aggiungere al flusso di output.

value: String

Stringa contenente il valore da assegnare all'attributo.

fEncode: Boolean

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

Esempio

Nell'esempio di codice seguente viene illustrato come usare il AddAttribute(HtmlTextWriterAttribute, String, Boolean) metodo per assicurarsi che il valore stringa assegnato a un attributo per un Alt<img> elemento sia codificato per il dispositivo richiedente.

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

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

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Commenti

Usare l'overload del metodo per eseguire il AddAttribute AddAttribute(HtmlTextWriterAttribute, String, Boolean) rendering di un attributo di markup standard, con codifica facoltativa.

Per un'istanza di un determinato elemento di markup, la HtmlTextWriter classe mantiene un elenco di attributi per tale elemento. Quando viene chiamato il RenderBeginTag metodo , tutti gli attributi aggiunti da AddAttribute vengono visualizzati nel tag di apertura dell'elemento . L'elenco di attributi viene quindi cancellato dall'oggetto HtmlTextWriter .

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

Se il tipo di attributo è Style, il valore non verrà codificato anche se fEncode è true. Assicurarsi che il valore di stile sia conforme a CSS e che non contenga codice dannoso.

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

Utilizzare il AddAttribute metodo per aggiungere attributi all'elemento .
Usare il metodo RenderBeginTag.
Usare altri metodi in base alle esigenze per eseguire il rendering del contenuto trovato tra i tag di apertura e chiusura dell'elemento.
Usare il metodo RenderEndTag.

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?