HtmlTextWriter.WriteAttribute Metodo

Definizione

Scrive un attributo di markup e il relativo valore nel flusso di output.Writes a markup attribute and its value to the output stream.

Overload

WriteAttribute(String, String, Boolean)

Scrive il valore e l'attributo di markup specificati nel flusso di output e, se specificato, scrive il valore codificato.Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

WriteAttribute(String, String)

Scrive l'attributo di markup specificato e il relativo valore nel flusso di output.Writes the specified markup attribute and value to the output stream.

WriteAttribute(String, String, Boolean)

Scrive il valore e l'attributo di markup specificati nel flusso di output e, se specificato, scrive il valore codificato.Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

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

name
String

Attributo di markup da scrivere nel flusso di output.The markup attribute to write to the output stream.

value
String

Valore assegnato all'attributo.The value assigned to the attribute.

fEncode
Boolean

true per codificare l'attributo e il valore assegnato. In caso contrario, false.true to encode the attribute and its assigned value; otherwise, false.

Esempi

Nell'esempio di codice riportato di seguito <img> viene illustrato il rendering di un elemento in cui WriteAttribute vengono chiamati entrambi gli overload del metodo.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. Nell'esempio di codice viene usato il processo seguente:The code example uses the following process:

  • Chiama il WriteBeginTag metodo, che esegue il rendering dei caratteri di apertura dell'elemento.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Chiama l' WriteAttribute(String, String) overload di, che scrive alt un attributo <img> e il relativo valore nell'elemento.Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • Chiama l' WriteAttribute(String, String, Boolean) overload per eseguire il rendering myattribute di un attributo personalizzato, con No "encoding" requiredun valore di e fEncode quindi falseimposta su.Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Chiude il tag di apertura dell'elemento, quindi chiama il WriteEndTag metodo per chiudere l' <img> elemento.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

In questo esempio di codice viene generato il markup seguente:This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Commenti

Usare il WriteAttribute metodo per scrivere gli attributi di markup e i relativi valori con o senza codifica.Use the WriteAttribute method to write markup attributes and their values with or without encoding. Il WriteAttribute metodo usa il HtmlAttributeEncode metodo per eseguire la codifica.The WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

Il WriteAttribute metodo scrive il valore dell'attributo racchiuso tra virgolette doppie (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Se value è null, ilWriteAttribute metodo scrive solo il nome dell'attributo.If value is null, the WriteAttribute method writes only the attribute name.

Note per gli eredi

Nelle classi derivate, è possibile WriteAttribute(String, String, Boolean) eseguire l'override del metodo per definire regole personalizzate per la scrittura degli attributi e dei relativi valori.In derived classes, you can override the WriteAttribute(String, String, Boolean) method to define custom rules for writing attributes and their values. Ad esempio, è possibile scrivere codice che consentiva WriteAttribute(String, String, Boolean) al metodo di scrivere un attributo con un valore vuoto.For example, you could write code that allowed the WriteAttribute(String, String, Boolean) method to write an attribute with an empty value.

Vedi anche

WriteAttribute(String, String)

Scrive l'attributo di markup specificato e il relativo valore nel flusso di output.Writes the specified markup attribute and value to the output stream.

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

name
String

Attributo da scrivere nel flusso di output.The attribute to write to the output stream.

value
String

Valore assegnato all'attributo.The value assigned to the attribute.

Esempi

Nell'esempio di codice riportato di seguito <img> viene illustrato il rendering di un elemento in cui WriteAttribute vengono chiamati entrambi gli overload del metodo.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. Nell'esempio di codice viene usato il processo seguente:The code example uses the following process:

  • Chiama il WriteBeginTag metodo, che esegue il rendering dei caratteri di apertura dell'elemento.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Chiama l' WriteAttribute(String, String) overload di, che scrive alt un attributo <img> e il relativo valore nell'elemento.Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • Chiama l' WriteAttribute(String, String, Boolean) overload per eseguire il rendering myattribute di un attributo personalizzato, con No "encoding" requiredun valore di e fEncode quindi falseimposta su.Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Chiude il tag di apertura dell'elemento, quindi chiama il WriteEndTag metodo per chiudere l' <img> elemento.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

In questo esempio di codice viene generato il markup seguente:This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Commenti

Usare il WriteAttribute metodo per scrivere gli attributi di markup e i relativi valori senza codifica.Use the WriteAttribute method to write markup attributes and their values with no encoding. Il WriteAttribute metodo scrive il valore dell'attributo racchiuso tra virgolette doppie (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Se value è null, ilWriteAttribute metodo scrive solo il nome dell'attributo.If value is null, the WriteAttribute method writes only the attribute name.

Note per gli eredi

Nelle classi derivate, è possibile WriteAttribute(String, String) eseguire l'override del metodo per definire regole personalizzate per la scrittura degli attributi e dei relativi valori.In derived classes, you can override the WriteAttribute(String, String) method to define custom rules for writing attributes and their values. Ad esempio, è possibile scrivere codice che consentiva WriteAttribute(String, String) al metodo di scrivere un attributo con un valore vuoto.For example, you could write code that allowed the WriteAttribute(String, String) method to write an attribute with an empty value.

Vedi anche

Si applica a