HtmlTextWriter.WriteAttribute Metoda
Definice
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í.
Zapíše atribut značky a jeho hodnotu do výstupního datového proudu.
Přetížení
| Name | Description |
|---|---|
| WriteAttribute(String, String, Boolean) |
Zapíše zadaný atribut a hodnotu značky do výstupního datového proudu a v případě zadání zapíše zakódovanou hodnotu. |
| 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 v případě zadání zapíše zakódovanou hodnotu.
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 značky 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> prvku, ve kterém jsou volány obě přetížení WriteAttribute metody. V příkladu kódu se používá následující proces:
Volá metodu WriteBeginTag , která vykreslí počáteční znaky elementu.
WriteAttribute(String, String) Volá přetížení, které zapisuje
altatribut a jeho hodnotu do elementu<img>.WriteAttribute(String, String, Boolean) Volá přetížení k vykreslení vlastního
myattributeatributu s hodnotouNo "encoding" required, a pak nastavífEncodenafalse.Zavře levou značku elementu a potom zavolá metodu WriteEndTag pro zavření elementu
<img>.
Tento příklad kódu vygeneruje následující kód:
<img alt="AtlValue" myattribute="No "encoding" 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
Metoda slouží k zápisu WriteAttribute atributů značek a jejich hodnot 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) pro definování vlastních pravidel 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é
Platí pro
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> prvku, ve kterém jsou volány obě přetížení WriteAttribute metody. V příkladu kódu se používá následující proces:
Volá metodu WriteBeginTag , která vykreslí počáteční znaky elementu.
WriteAttribute(String, String) Volá přetížení, které zapisuje
altatribut a jeho hodnotu do elementu<img>.WriteAttribute(String, String, Boolean) Volá přetížení k vykreslení vlastního
myattributeatributu s hodnotouNo "encoding" required, a pak nastavífEncodenafalse.Zavře levou značku elementu a potom zavolá metodu WriteEndTag pro zavření elementu
<img>.
Tento příklad kódu vygeneruje následující kód:
<img alt="AtlValue" myattribute="No "encoding" 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 Metoda slouží k zápisu atributů značek a jejich hodnot 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) pro definování vlastních pravidel 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.