HtmlTextWriter.AddAttribute Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

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

Overload

AddAttribute(String, String)	Aggiunge il valore e l'attributo di markup specificato al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al metodo RenderBeginTag.
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 metodo RenderBeginTag.
AddAttribute(String, String, Boolean)	Aggiunge il valore e l'attributo di markup specificato al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva del metodo RenderBeginTag, con codifica aggiuntiva.
AddAttribute(String, String, HtmlTextWriterAttribute)	Aggiunge il valore e l'attributo di markup specificato, oltre a un valore di enumerazione HtmlTextWriterAttribute, al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva del metodo RenderBeginTag.
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 del metodo RenderBeginTag, con codifica facoltativa.

AddAttribute(String, String)

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

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 AddAttribute e due overload diversi di prima di AddStyleAttribute chiamare il metodo per eseguire il RenderBeginTag rendering di un <span> elemento al 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 qualsiasi elemento di markup specificato, 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 gli elementi di markup per il rendering è 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

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

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 metodo RenderBeginTag.

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 AddAttributeAddAttribute(HtmlTextWriterAttribute, String) rendering di un attributo di markup standard.

Per un'istanza di qualsiasi elemento di markup specificato, 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 gli elementi di markup per il rendering è 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

• TextWriter
• RenderBeginTag
• RenderEndTag()

AddAttribute(String, String, Boolean)

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

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 garantire che un attributo personalizzato, denominato myattribute, e 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 oppure se l'attributo non è noto fino a quando non è necessaria la codifica e la fase di esecuzione.

Per un'istanza di qualsiasi elemento di markup specificato, 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 .

Utilizzare il AddAttribute(String, String, Boolean) metodo con fEncode impostato su true, se l'attributo può contenere una virgoletta ("), un segno minore di (<) o una 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 gli elementi di markup per il rendering è 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

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

AddAttribute(String, String, HtmlTextWriterAttribute)

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

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 si eredita dalla HtmlTextWriter classe . Consente di creare nuove name coppie e key per gli attributi.

Vedi anche

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

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 del metodo RenderBeginTag, 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 AddAttributeAddAttribute(HtmlTextWriterAttribute, String, Boolean) rendering di un attributo di markup standard, con codifica facoltativa.

Per un'istanza di qualsiasi elemento di markup specificato, 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 .

Utilizzare il AddAttribute(HtmlTextWriterAttribute, String, Boolean) metodo con fEncode impostato su true, se l'attributo può contenere una virgoletta ("), un segno minore di (<) o una 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 gli elementi di markup per il rendering è 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

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)