HtmlTextWriter.WriteAttribute Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Zapisuje atrybut znaczników i jego wartość do strumienia wyjściowego.

Przeciążenia

WriteAttribute(String, String, Boolean)	Zapisuje określony atrybut znaczników i wartość do strumienia wyjściowego, a jeśli określono, zapisuje wartość zakodowaną.
WriteAttribute(String, String)	Zapisuje określony atrybut znaczników i wartość do strumienia wyjściowego.

WriteAttribute(String, String, Boolean)

Zapisuje określony atrybut znaczników i wartość do strumienia wyjściowego, a jeśli określono, zapisuje wartość zakodowaną.

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

Atrybut znaczników do zapisu w strumieniu wyjściowym.

value

String

Wartość przypisana do atrybutu.

fEncode

Boolean

true zakodować atrybut i jego przypisaną wartość; w przeciwnym razie , false.

Przykłady

Poniższy przykład kodu przedstawia renderowanie <img> elementu, w którym wywoływane są oba przeciążenia WriteAttribute metody. W przykładzie kodu użyto następującego procesu:

• Wywołuje metodę WriteBeginTag , która renderuje znaki otwierające elementu.

• WriteAttribute(String, String) Wywołuje przeciążenie, które zapisuje alt atrybut i jego wartość do <img> elementu.

• WriteAttribute(String, String, Boolean) Wywołuje przeciążenie w celu renderowania atrybutu niestandardowego No "encoding" requiredmyattribute z wartością , a następnie ustawia wartość .falsefEncode

• Zamyka tag otwierający elementu, a następnie wywołuje metodę WriteEndTag , aby zamknąć <img> element.

W tym przykładzie kodu są generowane następujące znaczniki:

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

Uwagi

WriteAttribute Użyj metody , aby napisać atrybuty znaczników i ich wartości z kodowaniem lub bez niego. Metoda WriteAttribute używa HtmlAttributeEncode metody do kodowania.

Metoda WriteAttribute zapisuje wartość atrybutu ujętą w znaki podwójnego cudzysłowu ("). Jeśli value parametr ma nullwartość , WriteAttribute metoda zapisuje tylko nazwę atrybutu.

Uwagi dotyczące dziedziczenia

W klasach pochodnych można zastąpić metodę WriteAttribute(String, String, Boolean) , aby zdefiniować niestandardowe reguły pisania atrybutów i ich wartości. Można na przykład napisać kod, który pozwolił metodzie WriteAttribute(String, String, Boolean) na napisanie atrybutu z pustą wartością.

Zobacz też

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

WriteAttribute(String, String)

Zapisuje określony atrybut znaczników i wartość do strumienia wyjściowego.

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

Atrybut do zapisu w strumieniu wyjściowym.

value

String

Wartość przypisana do atrybutu.

Przykłady

Poniższy przykład kodu przedstawia renderowanie <img> elementu, w którym wywoływane są oba przeciążenia WriteAttribute metody. W przykładzie kodu użyto następującego procesu:

• Wywołuje metodę WriteBeginTag , która renderuje znaki otwierające elementu.

• WriteAttribute(String, String) Wywołuje przeciążenie, które zapisuje alt atrybut i jego wartość do <img> elementu.

• WriteAttribute(String, String, Boolean) Wywołuje przeciążenie w celu renderowania atrybutu niestandardowego No "encoding" requiredmyattribute z wartością , a następnie ustawia wartość .falsefEncode

• Zamyka tag otwierający elementu, a następnie wywołuje metodę WriteEndTag , aby zamknąć <img> element.

W tym przykładzie kodu są generowane następujące znaczniki:

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

Uwagi

WriteAttribute Użyj metody , aby zapisać atrybuty znaczników i ich wartości bez kodowania. Metoda WriteAttribute zapisuje wartość atrybutu ujętą w znaki podwójnego cudzysłowu ("). Jeśli value parametr ma nullwartość , WriteAttribute metoda zapisuje tylko nazwę atrybutu.

Uwagi dotyczące dziedziczenia

W klasach pochodnych można zastąpić metodę WriteAttribute(String, String) , aby zdefiniować niestandardowe reguły pisania atrybutów i ich wartości. Można na przykład napisać kod, który pozwolił metodzie WriteAttribute(String, String) na napisanie atrybutu z pustą wartością.

Zobacz też

• TextWriter