HtmlTextWriter.WriteAttribute Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Schreibt ein Markup-Attribut und dessen Wert in den Ausgabedatenstrom.

Überlädt

Name Beschreibung
WriteAttribute(String, String, Boolean)

Schreibt das angegebene Markup-Attribut und -Wert in den Ausgabedatenstrom und schreibt, falls angegeben, den Wert codiert.
WriteAttribute(String, String)

Schreibt das angegebene Markup-Attribut und -Wert in den Ausgabedatenstrom.

WriteAttribute(String, String, Boolean)

Schreibt das angegebene Markup-Attribut und -Wert in den Ausgabedatenstrom und schreibt, falls angegeben, den Wert codiert.

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

name
String

Das Markup-Attribut, das in den Ausgabedatenstrom geschrieben werden soll.

value
String

Der dem Attribut zugewiesene Wert.

fEncode
Boolean

trueum das Attribut und seinen zugewiesenen Wert zu codieren; andernfalls . false

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 Öffnenzeichen des Elements rendert.

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

  • Ruft die WriteAttribute(String, String, Boolean) Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit einem Wert von No "encoding" required, und legt fEncode sie dann auf false.

  • 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 doppelte Anführungszeichen ("). Wenn value ja 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önnen z. B. Code schreiben, mit dem die WriteAttribute(String, String, Boolean) Methode ein Attribut mit einem leeren Wert schreiben konnte.

Weitere Informationen

Gilt für:

WriteAttribute(String, String)

Schreibt das angegebene Markup-Attribut und -Wert in den Ausgabedatenstrom.

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

name
String

Das Attribut, das in den Ausgabedatenstrom geschrieben werden soll.

value
String

Der dem Attribut zugewiesene Wert.

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 Öffnenzeichen des Elements rendert.

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

  • Ruft die WriteAttribute(String, String, Boolean) Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit einem Wert von No "encoding" required, und legt fEncode sie dann auf false.

  • 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 doppelte Anführungszeichen ("). Wenn value ja 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önnen z. B. Code schreiben, mit dem die WriteAttribute(String, String) Methode ein Attribut mit einem leeren Wert schreiben konnte.

Weitere Informationen

Gilt für: