HtmlTextWriter.AddAttribute Metoda

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 prvku, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody.

Přetížení

Name	Description
AddAttribute(String, String)	Přidá zadaný atribut a hodnotu značky do počáteční značky prvku, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody.
AddAttribute(HtmlTextWriterAttribute, String)	Přidá atribut značek a hodnotu atributu do počáteční značky elementu, který HtmlTextWriter 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 prvku, 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 prvku, který HtmlTextWriter objekt vytvoří s následným voláním RenderBeginTag metody.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Přidá atribut značek 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 prvku, který HtmlTextWriter 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ý chcete přidat.

value: String

Řetězec obsahující hodnotu, která se má přiřadit k 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í a dvě různá přetížení AddAttribute AddStyleAttribute předtím, než volá metodu RenderBeginTag k vykreslení <span> prvku do výstupního datového proudu. Metoda AddAttribute(String, String) se používá k definování vlastní atribut pojmenovaný CustomAttribute a vlastní hodnota pojmenovaná CustomAttributeValue pro <span> element, který tento kód vykresluje.

// 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 Použijte přetížení AddAttribute(String, String) metody, pokud atribut není jednou z HtmlTextWriterAttribute hodnot, nebo pokud atribut není známý do doby běhu.

Pro instanci libovolného daného prvku HtmlTextWriter značek třída udržuje seznam atributů pro tento prvek. RenderBeginTag Při zavolání metody se všechny atributy přidané metodou AddAttribute vykreslují 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í:

Použijte metodu AddAttribute k přidání všech atributů do elementu.
Použijte metodu RenderBeginTag.
Pomocí jiných metod podle potřeby vykreslujte obsah nalezený mezi levou a pravou značkou prvku.
Použijte metodu RenderEndTag.

Viz také

Platí pro

AddAttribute(HtmlTextWriterAttribute, String)

Přidá atribut značek a hodnotu atributu do počáteční značky elementu, který HtmlTextWriter 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 značky, 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 k atributu.

Příklady

Následující příklad kódu ukazuje, jak pomocí AddAttribute přetížení AddAttribute(HtmlTextWriterAttribute, String) metody přidat Onclick atribut do prvku revize a pak jeho hodnotu nastavit na následující ECMAScript kód:

alert('Hello');

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

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

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

Poznámky

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

Pro instanci libovolného daného prvku HtmlTextWriter značek třída udržuje seznam atributů pro tento prvek. RenderBeginTag Při zavolání metody se všechny atributy přidané AddAttribute metodou vykreslují 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í:

Použijte metodu AddAttribute k přidání všech atributů do elementu.
Použijte metodu RenderBeginTag.
Pomocí jiných metod podle potřeby vykreslujte obsah nalezený mezi levou a pravou značkou prvku.
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 prvku, 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ý chcete přidat.

value: String

Řetězec obsahující hodnotu, která se má přiřadit k 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 myattributea 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 AddAttribute(String, String, Boolean) Přetížení metody použijte, pokud atribut není jednou z HtmlTextWriterAttribute hodnot, nebo pokud atribut není známý do doby běhu a kódování je potřeba.

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

Pokud je Styletyp atributu , hodnota nebude zakódována, i když fEndode je true. Ujistěte se, že hodnota stylu vyhovuje šabloně stylů CSS a neobsahuje škodlivý kód.

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

Použijte metodu AddAttribute k přidání všech atributů do elementu.
Použijte metodu RenderBeginTag.
Pomocí jiných metod podle potřeby vykreslujte obsah nalezený mezi levou a pravou značkou prvku.
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 prvku, který HtmlTextWriter 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ý chcete přidat.

value: String

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

key: HtmlTextWriterAttribute

Představuje HtmlTextWriterAttribute 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 značek 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 značky, 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 k 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 přiřazená Alt atributu <img> elementu 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 AddAttribute(HtmlTextWriterAttribute, String, Boolean) Přetížení metody použijte k vykreslení standardního atributu značek s volitelným kódováním.

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

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

Pokud je Styletyp atributu , hodnota nebude zakódována, i když fEncode je true. Ujistěte se, že hodnota stylu vyhovuje šabloně stylů CSS a neobsahuje škodlivý kód.

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

Použijte metodu AddAttribute k přidání všech atributů do elementu.
Použijte metodu RenderBeginTag.
Pomocí jiných metod podle potřeby vykreslujte obsah nalezený mezi levou a pravou značkou prvku.
Použijte metodu RenderEndTag.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?