HtmlTextWriter.WriteAttribute Method

Definition

Schreibt ein Markupattribut und dessen Wert in den Ausgabestream.Writes a markup attribute and its value to the output stream.

Overloads

WriteAttribute(String, String, Boolean)

Schreibt das angegebene Markupattribut und den Wert in den Ausgabestream und schreibt den codierten Wert (falls angegeben).Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

WriteAttribute(String, String)

Schreibt das angegebene Markupattribut und dessen Wert in den Ausgabestream.Writes the specified markup attribute and value to the output stream.

WriteAttribute(String, String, Boolean)

Schreibt das angegebene Markupattribut und den Wert in den Ausgabestream und schreibt den codierten Wert (falls angegeben).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)

Parameters

name
String

Das Markupattribut, das in den Ausgabestream geschrieben werden soll.The markup attribute to write to the output stream.

value
String

Der Wert, der dem Attribut zugewiesen ist.The value assigned to the attribute.

fEncode
Boolean

true , um das Attribut und seinen zugewiesenen Wert zu codieren, andernfalls false.true to encode the attribute and its assigned value; otherwise, false.

Examples

Das folgende Codebeispiel veranschaulicht das Rendern eines <img>-Elements, in dem beide über Ladungen der WriteAttribute-Methode aufgerufen werden.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. Das Codebeispiel verwendet den folgenden Prozess:The code example uses the following process:

  • Ruft die WriteBeginTag-Methode auf, die die öffnenden Zeichen des-Elements rendert.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Ruft die WriteAttribute(String, String)-Überladung auf, die ein alt Attribut und seinen Wert in das <img>-Element schreibt.Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • Ruft die WriteAttribute(String, String, Boolean)-Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit dem Wert No "encoding" requiredzu erzeugen, und legt dann fEncode auf falsefest.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.

  • Schließt das öffnende Tag des Elements und ruft dann die WriteEndTag-Methode auf, um das <img> Element zu schließen.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

In diesem Codebeispiel wird das folgende Markup generiert: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)

Remarks

Verwenden Sie die WriteAttribute-Methode, um Markup Attribute und deren Werte mit oder ohne Codierung zu schreiben.Use the WriteAttribute method to write markup attributes and their values with or without encoding. Die WriteAttribute-Methode verwendet die HtmlAttributeEncode-Methode, um die Codierung durchzuführen.The WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

Die WriteAttribute-Methode schreibt den Attribut Wert in doppelte Anführungszeichen (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Wenn value nullist, schreibt die WriteAttribute-Methode nur den Attributnamen.If value is null, the WriteAttribute method writes only the attribute name.

Notes to Inheritors

In abgeleiteten Klassen können Sie die WriteAttribute(String, String, Boolean)-Methode überschreiben, um benutzerdefinierte Regeln zum Schreiben von Attributen und deren Werten zu definieren.In derived classes, you can override the WriteAttribute(String, String, Boolean) method to define custom rules for writing attributes and their values. Beispielsweise können Sie Code schreiben, mit dem die WriteAttribute(String, String, Boolean)-Methode ein Attribut mit einem leeren Wert schreiben konnte.For example, you could write code that allowed the WriteAttribute(String, String, Boolean) method to write an attribute with an empty value.

See also

WriteAttribute(String, String)

Schreibt das angegebene Markupattribut und dessen Wert in den Ausgabestream.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)

Parameters

name
String

Das Attribut, das in den Ausgabestream geschrieben werden soll.The attribute to write to the output stream.

value
String

Der Wert, der dem Attribut zugewiesen ist.The value assigned to the attribute.

Examples

Das folgende Codebeispiel veranschaulicht das Rendern eines <img>-Elements, in dem beide über Ladungen der WriteAttribute-Methode aufgerufen werden.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. Das Codebeispiel verwendet den folgenden Prozess:The code example uses the following process:

  • Ruft die WriteBeginTag-Methode auf, die die öffnenden Zeichen des-Elements rendert.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Ruft die WriteAttribute(String, String)-Überladung auf, die ein alt Attribut und seinen Wert in das <img>-Element schreibt.Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • Ruft die WriteAttribute(String, String, Boolean)-Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit dem Wert No "encoding" requiredzu erzeugen, und legt dann fEncode auf falsefest.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.

  • Schließt das öffnende Tag des Elements und ruft dann die WriteEndTag-Methode auf, um das <img> Element zu schließen.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

In diesem Codebeispiel wird das folgende Markup generiert: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)

Remarks

Verwenden Sie die WriteAttribute-Methode, um Markup Attribute und deren Werte ohne Codierung zu schreiben.Use the WriteAttribute method to write markup attributes and their values with no encoding. Die WriteAttribute-Methode schreibt den Attribut Wert in doppelte Anführungszeichen (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Wenn value nullist, schreibt die WriteAttribute-Methode nur den Attributnamen.If value is null, the WriteAttribute method writes only the attribute name.

Notes to Inheritors

In abgeleiteten Klassen können Sie die WriteAttribute(String, String)-Methode überschreiben, um benutzerdefinierte Regeln zum Schreiben von Attributen und deren Werten zu definieren.In derived classes, you can override the WriteAttribute(String, String) method to define custom rules for writing attributes and their values. Beispielsweise können Sie Code schreiben, mit dem die WriteAttribute(String, String)-Methode ein Attribut mit einem leeren Wert schreiben konnte.For example, you could write code that allowed the WriteAttribute(String, String) method to write an attribute with an empty value.

See also

Applies to