HtmlTextWriter.WriteAttribute Metodo

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);

public virtual void WriteAttribute (string name, string value, bool fEncode);

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

Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

Parametri

Esempio

Nell'esempio di codice seguente viene illustrato il rendering di un <img> elemento in cui vengono chiamati entrambi gli overload del WriteAttribute metodo . Nell'esempio di codice viene usato il processo seguente:

• Chiama il metodo , che esegue il WriteBeginTag rendering dei caratteri di apertura dell'elemento.

• Chiama l'overload WriteAttribute(String, String) , che scrive un alt attributo e il relativo valore nell'elemento <img> .

• Chiama l'overload per eseguire il WriteAttribute(String, String, Boolean) rendering di un attributo personalizzato myattribute , con un valore , No "encoding" requirede quindi imposta su fEncodefalse.

• Chiude il tag di apertura dell'elemento e quindi chiama il WriteEndTag metodo per chiudere l'elemento <img> .

Questo esempio di codice genera il markup seguente:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Commenti

Usare il WriteAttribute metodo per scrivere attributi di markup e i relativi valori con o senza codifica. Il WriteAttribute metodo usa il HtmlAttributeEncode metodo per eseguire la codifica.

Il WriteAttribute metodo scrive il valore dell'attributo racchiuso tra virgolette doppie ("). Se value è null, il WriteAttribute metodo scrive solo il nome dell'attributo.

Note per gli eredi

Nelle classi derivate è possibile eseguire l'override del WriteAttribute(String, String, Boolean) metodo per definire regole personalizzate per la scrittura di attributi e i relativi valori. Ad esempio, è possibile scrivere codice che ha consentito al WriteAttribute(String, String, Boolean) metodo di scrivere un attributo con un valore vuoto.

Vedi anche

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

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

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

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

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

Parametri

Esempio

Nell'esempio di codice seguente viene illustrato il rendering di un <img> elemento in cui vengono chiamati entrambi gli overload del WriteAttribute metodo . Nell'esempio di codice viene usato il processo seguente:

• Chiama il metodo , che esegue il WriteBeginTag rendering dei caratteri di apertura dell'elemento.

• Chiama l'overload WriteAttribute(String, String) , che scrive un alt attributo e il relativo valore nell'elemento <img> .

• Chiama l'overload per eseguire il WriteAttribute(String, String, Boolean) rendering di un attributo personalizzato myattribute , con un valore , No "encoding" requirede quindi imposta su fEncodefalse.

• Chiude il tag di apertura dell'elemento e quindi chiama il WriteEndTag metodo per chiudere l'elemento <img> .

Questo esempio di codice genera il markup seguente:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Commenti

Usare il WriteAttribute metodo per scrivere attributi di markup e i relativi valori senza codifica. Il WriteAttribute metodo scrive il valore dell'attributo racchiuso tra virgolette doppie ("). Se value è null, il WriteAttribute metodo scrive solo il nome dell'attributo.

Note per gli eredi

Nelle classi derivate è possibile eseguire l'override del WriteAttribute(String, String) metodo per definire regole personalizzate per la scrittura di attributi e i relativi valori. Ad esempio, è possibile scrivere codice che ha consentito al WriteAttribute(String, String) metodo di scrivere un attributo con un valore vuoto.

Vedi anche

• TextWriter