HtmlTextWriter.AddAttribute Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert hinzu.

Überlädt

AddAttribute(String, String)	Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert hinzu.
AddAttribute(HtmlTextWriterAttribute, String)	Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das Markupattribut und den Attributwert hinzu.
AddAttribute(String, String, Boolean)	Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert mit einer optionalen Codierung hinzu.
AddAttribute(String, String, HtmlTextWriterAttribute)	Fügt dem Starttag des Elements, das das HtmlTextWriterAttribute-Objekt erstellt und anschließend die HtmlTextWriter-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert sowie einen RenderBeginTag-Enumerationswert hinzu.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das Markupattribut und den Attributwert mit einer optionalen Codierung hinzu.

AddAttribute(String, String)

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert hinzu.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute (string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Parameter

name

String

Eine Zeichenfolge mit dem Namen des Attributs, das hinzugefügt wird.

value

String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AddAttribute -Methode aufgerufen wird, bevor die RenderBeginTag -Methode aufgerufen wird. Der Code ruft zwei verschiedene Überladungen von AddAttribute und zwei verschiedene Überladungen von AddStyleAttribute auf, bevor er die RenderBeginTag -Methode aufruft, um ein <span> Element im Ausgabedatenstrom zu rendern. Die AddAttribute(String, String) -Methode wird verwendet, um das benutzerdefinierte Attribut mit dem Namen CustomAttribute und den benutzerdefinierten Wert für CustomAttributeValue das <span> Element zu definieren, das von diesem Code gerendert wird.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Hinweise

Verwenden Sie die AddAttribute -Überladung der AddAttribute(String, String) -Methode, wenn das Attribut nicht einer der HtmlTextWriterAttribute Werte ist oder wenn das Attribut erst zur Laufzeit bekannt ist.

Für eine instance eines bestimmten Markupelements verwaltet die HtmlTextWriter -Klasse eine Liste von Attributen für dieses Element. Wenn die RenderBeginTag Methode aufgerufen wird, werden alle attribute, die von der AddAttribute -Methode hinzugefügt wurden, in das öffnende Tag des Elements gerendert. Die Liste der Attribute wird dann aus dem HtmlTextWriter -Objekt gelöscht.

Das Codierungsmuster für das Rendern von Markupelementen sieht wie folgt aus:

• Verwenden Sie die AddAttribute -Methode, um dem -Element Attribute hinzuzufügen.

• Verwenden Sie die RenderBeginTag-Methode.

• Verwenden Sie nach Bedarf andere Methoden, um den Inhalt zu rendern, der zwischen den öffnenden und schließenden Tags des Elements gefunden wurde.

• Verwenden Sie die RenderEndTag-Methode.

Weitere Informationen

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

AddAttribute(HtmlTextWriterAttribute, String)

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das Markupattribut und den Attributwert hinzu.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Parameter

key

HtmlTextWriterAttribute

Ein HtmlTextWriterAttribute, das das Markupattribut darstellt, das dem Ausgabestream hinzugefügt werden soll.

value

String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen werden soll.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie sie die AddAttribute -Überladung der AddAttribute(HtmlTextWriterAttribute, String) -Methode verwenden, um einem Markupelement ein Onclick Attribut hinzuzufügen und dann dessen Wert auf den folgenden ECMAScript-Code festzulegen:

alert('Hello');  

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Hinweise

Verwenden Sie die AddAttribute -Überladung der AddAttribute(HtmlTextWriterAttribute, String) -Methode, um ein Standardmarkuptribut zu rendern.

Für eine instance eines bestimmten Markupelements verwaltet die HtmlTextWriter -Klasse eine Liste von Attributen für dieses Element. Wenn die RenderBeginTag -Methode aufgerufen wird, werden alle Attribute, die von der AddAttribute -Methode hinzugefügt werden, in das öffnende Tag des Elements gerendert. Die Liste der Attribute wird dann aus HtmlTextWriterdem gelöscht.

Das Codierungsmuster für das Rendern von Markupelementen sieht wie folgt aus:

• Verwenden Sie die AddAttribute -Methode, um dem -Element Attribute hinzuzufügen.

• Verwenden Sie die RenderBeginTag-Methode.

• Verwenden Sie nach Bedarf andere Methoden, um den Inhalt zu rendern, der zwischen den öffnenden und schließenden Tags des Elements gefunden wurde.

• Verwenden Sie die RenderEndTag-Methode.

Weitere Informationen

• TextWriter
• RenderBeginTag
• RenderEndTag()

AddAttribute(String, String, Boolean)

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert mit einer optionalen Codierung hinzu.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute (string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Parameter

name

String

Eine Zeichenfolge mit dem Namen des Attributs, das hinzugefügt wird.

value

String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen werden soll.

fEndode

Boolean

true, wenn das Attribut und sein Wert codiert werden sollen, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AddAttribute -Überladung der AddAttribute(String, String, Boolean) -Methode verwendet wird, um sicherzustellen, dass ein benutzerdefiniertes Attribut mit dem Namen myattributeund dessen Wert nicht für ein <img> Element codiert sind.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Hinweise

Verwenden Sie die AddAttribute -Überladung der AddAttribute(String, String, Boolean) -Methode, wenn das Attribut keiner der HtmlTextWriterAttribute Werte ist oder wenn das Attribut erst bekannt ist, wenn die Laufzeit und die Codierung erforderlich ist.

Für eine instance eines bestimmten Markupelements verwaltet die HtmlTextWriter -Klasse eine Liste von Attributen für dieses Element. Wenn die RenderBeginTag Methode aufgerufen wird, werden alle attribute, die von der AddAttribute -Methode hinzugefügt wurden, in das öffnende Tag des Elements gerendert. Die Liste der Attribute wird dann aus dem HtmlTextWriter -Objekt gelöscht.

Verwenden Sie die AddAttribute(String, String, Boolean) -Methode mit fEncode festgelegt auf true, wenn das Attribut möglicherweise ein Anführungszeichen ("), ein kleiner als-Zeichen (<) oder ein ampersand (&) enthalten kann. Der Methodenaufruf codiert das Attribut, um die Anforderungen des anfordernden Geräts zu erfüllen. Sie können auf falsefestlegenfEncode, wenn Sie wissen, dass keines dieser Zeichen generiert wird, oder wenn Sie wissen, dass das Attribut bereits codiert ist.

Wenn der Attributtyp ist Style, wird der Wert nicht codiert, auch wenn fEndodetrueist. Stellen Sie sicher, dass der Stilwert CSS-kompatibel ist und keinen schädlichen Code enthält.

Das Codierungsmuster für das Rendern von Markupelementen sieht wie folgt aus:

• Verwenden Sie die AddAttribute -Methode, um dem -Element Attribute hinzuzufügen.

• Verwenden Sie die RenderBeginTag-Methode.

• Verwenden Sie nach Bedarf andere Methoden, um den Inhalt zu rendern, der zwischen den öffnenden und schließenden Tags des Elements gefunden wurde.

• Verwenden Sie die RenderEndTag-Methode.

Weitere Informationen

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

AddAttribute(String, String, HtmlTextWriterAttribute)

Fügt dem Starttag des Elements, das das HtmlTextWriterAttribute-Objekt erstellt und anschließend die HtmlTextWriter-Methode aufruft, das festgelegte Markupattribut und den festgelegten Markupwert sowie einen RenderBeginTag-Enumerationswert hinzu.

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Parameter

name

String

Eine Zeichenfolge mit dem Namen des Attributs, das hinzugefügt wird.

value

String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen werden soll.

key

HtmlTextWriterAttribute

Ein HtmlTextWriterAttribute, das das Attribut darstellt.

Hinweise

Verwenden Sie die AddAttribute -Überladung der AddAttribute(String, String, HtmlTextWriterAttribute) -Methode nur, wenn Sie von der HtmlTextWriter -Klasse erben. Dadurch können Sie neue name Und-Paare key für Attribute erstellen.

Weitere Informationen

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, das Markupattribut und den Attributwert mit einer optionalen Codierung hinzu.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Parameter

key

HtmlTextWriterAttribute

Ein HtmlTextWriterAttribute, das das Markupattribut darstellt, das dem Ausgabestream hinzugefügt werden soll.

value

String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen werden soll.

fEncode

Boolean

true, wenn das Attribut und sein Wert codiert werden sollen, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AddAttribute(HtmlTextWriterAttribute, String, Boolean) -Methode verwendet wird, um sicherzustellen, dass der Zeichenfolgenwert, der einem Alt Attribut für ein <img> Element zugewiesen ist, für das anfordernde Gerät codiert wird.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Hinweise

Verwenden Sie die AddAttribute -Überladung der AddAttribute(HtmlTextWriterAttribute, String, Boolean) -Methode, um ein Standardmarkuptribut mit optionaler Codierung zu rendern.

Für eine instance eines bestimmten Markupelements verwaltet die HtmlTextWriter -Klasse eine Liste von Attributen für dieses Element. Wenn die RenderBeginTag -Methode aufgerufen wird, werden alle attribute, die von hinzugefügt AddAttribute werden, in das öffnende Tag des Elements gerendert. Die Liste der Attribute wird dann aus dem HtmlTextWriter -Objekt gelöscht.

Verwenden Sie die AddAttribute(HtmlTextWriterAttribute, String, Boolean) -Methode mit fEncode festgelegt auf true, wenn das Attribut möglicherweise ein Anführungszeichen ("), ein kleiner als-Zeichen (<) oder ein ampersand (&) enthalten kann. Der Methodenaufruf codiert das Attribut, um die Anforderungen des anfordernden Geräts zu erfüllen. Sie können auf falsefestlegenfEncode, wenn Sie wissen, dass keines dieser Zeichen generiert wird, oder wenn Sie wissen, dass das Attribut bereits codiert ist.

Wenn der Attributtyp ist Style, wird der Wert nicht codiert, auch wenn fEncodetrueist. Stellen Sie sicher, dass der Stilwert CSS-kompatibel ist und keinen schädlichen Code enthält.

Das Codierungsmuster für das Rendern von Markupelementen sieht wie folgt aus:

• Verwenden Sie die AddAttribute -Methode, um dem -Element Attribute hinzuzufügen.

• Verwenden Sie die RenderBeginTag-Methode.

• Verwenden Sie nach Bedarf andere Methoden, um den Inhalt zu rendern, der zwischen den öffnenden und schließenden Tags des Elements gefunden wurde.

• Verwenden Sie die RenderEndTag-Methode.

Weitere Informationen

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)