HtmlTextWriter.AddAttribute Metoda

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)

Parametry

Příklady

Následující příklad kódu ukazuje, jak volat metodu AddAttribute před voláním RenderBeginTag metody. Kód volá dvě různá přetížení AddAttribute a dvě různá AddStyleAttribute přetížení před voláním RenderBeginTag metody vykreslovat <span> prvek do výstupního datového proudu. Metoda AddAttribute(String, String) se používá k definování vlastního atributu s názvem CustomAttribute a vlastní hodnoty s názvem CustomAttributeValue pro <span> prvek, který tento kód vykreslí.

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

Poznámky

AddAttribute Přetížení metody použijte, AddAttribute(String, String) pokud atribut není jednou z HtmlTextWriterAttribute hodnot nebo pokud atribut není znám až do běhu.

Pro instanci libovolného prvku HtmlTextWriter značek třída udržuje seznam atributů pro tento prvek. Při zavolání RenderBeginTag metody jsou všechny atributy přidané metodou AddAttribute vykresleny do počáteční značky elementu. Seznam atributů se pak vymaže z objektu HtmlTextWriter .

Vzor kódování pro vykreslování prvků značek je následující:

• AddAttribute Pomocí metody přidejte do elementu všechny atributy.

• Použijte metodu RenderBeginTag.

• Podle potřeby použijte jiné metody k vykreslení obsahu nalezeného mezi levou a pravou značkou elementu.

• Použijte metodu RenderEndTag.

Viz také

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

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)

Parametry

Příklady

Následující příklad kódu ukazuje, jak použít AddAttribute přetížení AddAttribute(HtmlTextWriterAttribute, String) metody k přidání atributu Onclick do elementu markup a pak nastavit jeho hodnotu na následující kód ECMAScript:

alert('Hello');  

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

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

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

Poznámky

AddAttribute Přetížení metody použijte k vykreslení standardního AddAttribute(HtmlTextWriterAttribute, String) atributu značek.

Pro instanci libovolného prvku HtmlTextWriter značek třída udržuje seznam atributů pro tento prvek. RenderBeginTag Když je volána metoda, všechny atributy, které jsou přidány metodou AddAttribute jsou vykresleny do počáteční značky elementu. Seznam atributů se pak vymaže HtmlTextWriterz .

Vzor kódování pro vykreslování prvků značek je následující:

• AddAttribute Pomocí metody přidejte do elementu všechny atributy.

• Použijte metodu RenderBeginTag.

• Podle potřeby použijte jiné metody k vykreslení obsahu nalezeného mezi levou a pravou značkou elementu.

• Použijte metodu RenderEndTag.

Viz také

• TextWriter
• RenderBeginTag
• RenderEndTag()

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)

Parametry

Příklady

Následující příklad kódu ukazuje, jak použít AddAttribute přetížení AddAttribute(String, String, Boolean) metody k zajištění, že vlastní atribut s názvem myattribute, a jeho hodnota nejsou kódovány pro <img> prvek.

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

Poznámky

AddAttribute Přetížení metody použijte, AddAttribute(String, String, Boolean) pokud atribut není jednou z HtmlTextWriterAttribute hodnot nebo pokud atribut není známý, dokud není doba běhu a není nutné kódování.

Pro instanci libovolného prvku HtmlTextWriter značek třída udržuje seznam atributů pro tento prvek. Při zavolání RenderBeginTag metody jsou všechny atributy přidané metodou AddAttribute vykresleny do počáteční značky elementu. Seznam atributů se pak vymaže z objektu HtmlTextWriter .

Použijte metodu AddAttribute(String, String, Boolean) s fEncode nastavenou na true, pokud atribut může obsahovat uvozovky (), znak menší než (<) nebo ampersand (&). Volání metody kóduje atribut tak, aby splňoval požadavky žádajícího zařízení. Pokud víte, že se žádný z těchto znaků nevygeneruje, nebo pokud víte, že atribut je již zakódovaný, můžete nastavit fEncode na falsehodnotu .

Pokud je Styletyp atributu , hodnota se nezakóduje, i když fEndode je true. Ujistěte se, že hodnota stylu odpovídá šabloně stylů CSS a neobsahuje škodlivý kód.

Vzor kódování pro vykreslování prvků značek je následující:

• AddAttribute Pomocí metody přidejte do elementu všechny atributy.

• Použijte metodu RenderBeginTag.

• Podle potřeby použijte jiné metody k vykreslení obsahu nalezeného mezi levou a pravou značkou elementu.

• Použijte metodu RenderEndTag.

Viz také

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

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)

Parametry

Poznámky

AddAttributeAddAttribute(String, String, HtmlTextWriterAttribute) Přetížení metody použijte pouze při dědění z HtmlTextWriter třídy. Umožňuje vytvářet nové name a key páry pro atributy.

Viz také

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

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)

Parametry

Příklady

Následující příklad kódu ukazuje, jak použít metodu AddAttribute(HtmlTextWriterAttribute, String, Boolean) k zajištění, že řetězcová hodnota, která je přiřazena atributu Alt elementu <img> , je kódována pro žádající zařízení.

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

Poznámky

AddAttribute Přetížení metody použijte k vykreslení standardního AddAttribute(HtmlTextWriterAttribute, String, Boolean) atributu značek s volitelným kódováním.

Pro instanci libovolného prvku HtmlTextWriter značek třída udržuje seznam atributů pro tento prvek. Při zavolání RenderBeginTag metody jsou všechny atributy přidané objektem AddAttribute vykresleny do počáteční značky elementu. Seznam atributů se pak vymaže z objektu HtmlTextWriter .

Použijte metodu AddAttribute(HtmlTextWriterAttribute, String, Boolean) s fEncode nastavenou na true, pokud atribut může obsahovat uvozovky (), znak menší než (<) nebo ampersand (&). Volání metody kóduje atribut tak, aby splňoval požadavky žádajícího zařízení. Pokud víte, že se žádný z těchto znaků nevygeneruje, nebo pokud víte, že atribut je již zakódovaný, můžete nastavit fEncode na falsehodnotu .

Pokud je Styletyp atributu , hodnota se nezakóduje, i když fEncode je true. Ujistěte se, že hodnota stylu odpovídá šabloně stylů CSS a neobsahuje škodlivý kód.

Vzor kódování pro vykreslování prvků značek je následující:

• AddAttribute Pomocí metody přidejte do elementu všechny atributy.

• Použijte metodu RenderBeginTag.

• Podle potřeby použijte jiné metody k vykreslení obsahu nalezeného mezi levou a pravou značkou elementu.

• Použijte metodu RenderEndTag.

Viz také

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