HtmlTextWriter.WriteAttribute Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Zapíše atribut značky a jeho hodnotu do výstupního datového proudu.

Přetížení

WriteAttribute(String, String, Boolean)	Zapíše zadaný atribut a hodnotu značky do výstupního datového proudu a pokud je zadaný, zapíše hodnotu zakódovanou.
WriteAttribute(String, String)	Zapíše zadaný atribut značky a hodnotu do výstupního datového proudu.

WriteAttribute(String, String, Boolean)

Zapíše zadaný atribut a hodnotu značky do výstupního datového proudu a pokud je zadaný, zapíše hodnotu zakódovanou.

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)

Parametry

name

String

Atribut markup pro zápis do výstupního datového proudu.

value

String

Hodnota přiřazená atributu.

fEncode

Boolean

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

Příklady

Následující příklad kódu ukazuje vykreslení <img> elementu, ve kterém jsou volány obě přetížení WriteAttribute metody. Příklad kódu používá následující proces:

• Volá metodu WriteBeginTag , která vykreslí počáteční znaky elementu.

• WriteAttribute(String, String) Zavolá přetížení, které zapíše alt atribut a jeho hodnotu do elementu<img>.

• WriteAttribute(String, String, Boolean) Zavolá přetížení pro vykreslení vlastního myattribute atributu s hodnotou No "encoding" requireda pak nastaví fEncode na false.

• Zavře levou značku elementu a pak zavolá metodu WriteEndTag k zavření elementu <img> .

Tento příklad kódu vygeneruje následující kód:

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

Poznámky

WriteAttribute Pomocí metody můžete psát atributy značek a jejich hodnoty s kódováním nebo bez kódování. Metoda WriteAttribute používá metodu HtmlAttributeEncode k kódování.

Metoda WriteAttribute zapíše hodnotu atributu uzavřenou do dvojitých uvozovek ("). Pokud value je null, WriteAttribute metoda zapíše pouze název atributu.

Poznámky pro dědice

V odvozených třídách můžete přepsat metodu WriteAttribute(String, String, Boolean) a definovat vlastní pravidla pro zápis atributů a jejich hodnot. Můžete například napsat kód, který metodě umožnil WriteAttribute(String, String, Boolean) napsat atribut s prázdnou hodnotou.

Viz také

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

WriteAttribute(String, String)

Zapíše zadaný atribut značky a hodnotu do výstupního datového proudu.

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)

Parametry

name

String

Atribut pro zápis do výstupního datového proudu.

value

String

Hodnota přiřazená atributu.

Příklady

Následující příklad kódu ukazuje vykreslení <img> elementu, ve kterém jsou volány obě přetížení WriteAttribute metody. Příklad kódu používá následující proces:

• Volá metodu WriteBeginTag , která vykreslí počáteční znaky elementu.

• WriteAttribute(String, String) Zavolá přetížení, které zapíše alt atribut a jeho hodnotu do elementu<img>.

• WriteAttribute(String, String, Boolean) Zavolá přetížení pro vykreslení vlastního myattribute atributu s hodnotou No "encoding" requireda pak nastaví fEncode na false.

• Zavře levou značku elementu a pak zavolá metodu WriteEndTag k zavření elementu <img> .

Tento příklad kódu vygeneruje následující kód:

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

Poznámky

WriteAttribute Pomocí metody můžete psát atributy značek a jejich hodnoty bez kódování. Metoda WriteAttribute zapíše hodnotu atributu uzavřenou do dvojitých uvozovek ("). Pokud value je null, WriteAttribute metoda zapíše pouze název atributu.

Poznámky pro dědice

V odvozených třídách můžete přepsat metodu WriteAttribute(String, String) a definovat vlastní pravidla pro zápis atributů a jejich hodnot. Můžete například napsat kód, který metodě umožnil WriteAttribute(String, String) napsat atribut s prázdnou hodnotou.

Viz také

• TextWriter