HtmlTextWriter.WriteAttribute Methode

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)

Parameter

Beispiele

Im folgenden Codebeispiel wird das Rendern eines <img> Elements veranschaulicht, in dem beide Überladungen der WriteAttribute -Methode aufgerufen werden. Im Codebeispiel wird der folgende Prozess verwendet:

• Ruft die WriteBeginTag -Methode auf, die die öffnenden Zeichen des Elements rendert.

• Ruft die WriteAttribute(String, String) Überladung auf, die ein alt Attribut und dessen Wert in das <img> -Element schreibt.

• Ruft die WriteAttribute(String, String, Boolean) Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit dem Wert zu No "encoding" requiredrendern, und legt dann auf fest fEncodefalse.

• Schließt das öffnende Tag des Elements und ruft dann die WriteEndTag -Methode auf, um das <img> Element zu schließen.

In diesem Codebeispiel wird das folgende Markup generiert:

<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)

Hinweise

Verwenden Sie die WriteAttribute -Methode, um Markupattribute und deren Werte mit oder ohne Codierung zu schreiben. Die WriteAttribute -Methode verwendet die HtmlAttributeEncode -Methode, um die Codierung zu erledigen.

Die WriteAttribute -Methode schreibt den Attributwert in doppelten Anführungszeichen ("). Wenn value ist null, schreibt die WriteAttribute -Methode nur den Attributnamen.

Hinweise für Vererber

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. Sie könnten beispielsweise Code schreiben, mit dem die WriteAttribute(String, String, Boolean) -Methode ein Attribut mit einem leeren Wert schreiben konnte.

Weitere Informationen

• 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)

Parameter

Beispiele

Im folgenden Codebeispiel wird das Rendern eines <img> Elements veranschaulicht, in dem beide Überladungen der WriteAttribute -Methode aufgerufen werden. Im Codebeispiel wird der folgende Prozess verwendet:

• Ruft die WriteBeginTag -Methode auf, die die öffnenden Zeichen des Elements rendert.

• Ruft die WriteAttribute(String, String) Überladung auf, die ein alt Attribut und dessen Wert in das <img> -Element schreibt.

• Ruft die WriteAttribute(String, String, Boolean) Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit dem Wert zu No "encoding" requiredrendern, und legt dann auf fest fEncodefalse.

• Schließt das öffnende Tag des Elements und ruft dann die WriteEndTag -Methode auf, um das <img> Element zu schließen.

In diesem Codebeispiel wird das folgende Markup generiert:

<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)

Hinweise

Verwenden Sie die WriteAttribute -Methode, um Markupattribute und deren Werte ohne Codierung zu schreiben. Die WriteAttribute -Methode schreibt den Attributwert in doppelten Anführungszeichen ("). Wenn value ist null, schreibt die WriteAttribute -Methode nur den Attributnamen.

Hinweise für Vererber

In abgeleiteten Klassen können Sie die WriteAttribute(String, String) -Methode überschreiben, um benutzerdefinierte Regeln zum Schreiben von Attributen und deren Werten zu definieren. Sie könnten beispielsweise Code schreiben, mit dem die WriteAttribute(String, String) -Methode ein Attribut mit einem leeren Wert schreiben konnte.

Weitere Informationen

• TextWriter