Freigeben über


HtmlTextWriter.WriteAttribute Methode

Definition

Schreibt ein Markupattribut und dessen Wert in den Ausgabestream.

Überlädt

WriteAttribute(String, String, Boolean)

Schreibt das angegebene Markupattribut und den Wert in den Ausgabestream und schreibt den codierten Wert (falls angegeben).

WriteAttribute(String, String)

Schreibt das angegebene Markupattribut und dessen Wert in den Ausgabestream.

WriteAttribute(String, String, Boolean)

Schreibt das angegebene Markupattribut und den Wert in den Ausgabestream und schreibt den codierten Wert (falls angegeben).

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 Markupattribut, das in den Ausgabestream geschrieben werden soll.

value
String

Der Wert, der dem Attribut zugewiesen ist.

fEncode
Boolean

true, um 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 ö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

Gilt für:

WriteAttribute(String, String)

Schreibt das angegebene Markupattribut und dessen Wert in den Ausgabestream.

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 Ausgabestream geschrieben werden soll.

value
String

Der Wert, der dem Attribut zugewiesen ist.

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

Gilt für: