HtmlTextWriter.AddAttribute Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá zadaný atribut a hodnotu značky do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.

Přetížení

AddAttribute(String, String)	Přidá zadaný atribut a hodnotu značky do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.
AddAttribute(HtmlTextWriterAttribute, String)	Přidá atribut značky a hodnotu atributu do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.
AddAttribute(String, String, Boolean)	Přidá zadaný atribut a hodnotu značky do počáteční značky elementu, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody s volitelným kódováním.
AddAttribute(String, String, HtmlTextWriterAttribute)	Přidá zadaný atribut a hodnotu značky spolu s HtmlTextWriterAttribute hodnotou výčtu do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Přidá atribut markup a hodnotu atributu do počáteční značky elementu, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody s volitelným kódováním.

AddAttribute(String, String)

Přidá zadaný atribut a hodnotu značky do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.

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

name: String

Řetězec obsahující název atributu, který se má přidat.

value: String

Řetězec obsahující hodnotu, která se má přiřadit atributu.

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é

Platí pro

AddAttribute(HtmlTextWriterAttribute, String)

Přidá atribut značky a hodnotu atributu do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.

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

key: HtmlTextWriterAttribute

Představuje HtmlTextWriterAttribute atribut markup, který se má přidat do výstupního datového proudu.

value: String

Řetězec obsahující hodnotu, která se má přiřadit atributu.

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é

Platí pro

AddAttribute(String, String, Boolean)

Přidá zadaný atribut a hodnotu značky do počáteční značky elementu, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody s volitelným kódováním.

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

name: String

Řetězec obsahující název atributu, který se má přidat.

value: String

Řetězec obsahující hodnotu, která se má přiřadit atributu.

fEndode: Boolean

truekódovat atribut a jeho hodnotu; v opačném případě . false

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í.

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é

Platí pro

AddAttribute(String, String, HtmlTextWriterAttribute)

Přidá zadaný atribut a hodnotu značky spolu s HtmlTextWriterAttribute hodnotou výčtu do počáteční značky elementu HtmlTextWriter , který objekt vytvoří s následným voláním RenderBeginTag metody.

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

name: String

Řetězec obsahující název atributu, který se má přidat.

value: String

Řetězec obsahující hodnotu, která se má přiřadit atributu.

key: HtmlTextWriterAttribute

Objekt HtmlTextWriterAttribute , který představuje atribut.

Poznámky

AddAttribute AddAttribute(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é

Platí pro

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Přidá atribut markup a hodnotu atributu do počáteční značky elementu, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody s volitelným kódováním.

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

key: HtmlTextWriterAttribute

Představuje HtmlTextWriterAttribute atribut markup, který se má přidat do výstupního datového proudu.

value: String

Řetězec obsahující hodnotu, která se má přiřadit atributu.

fEncode: Boolean

truekódovat atribut a jeho hodnotu; v opačném případě . false

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é

Platí pro

Sdílet prostřednictvím

HtmlTextWriter.AddAttribute Metoda

Definice

Přetížení

AddAttribute(String, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

AddAttribute(HtmlTextWriterAttribute, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

AddAttribute(String, String, Boolean)

Parametry

Příklady

Poznámky

Viz také

Platí pro

AddAttribute(String, String, HtmlTextWriterAttribute)

Parametry

Poznámky

Viz také

Platí pro

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Další materiály