HtmlTextWriter.WriteAttribute Metoda
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapisuje atrybut znaczników i jego 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ą. |
| WriteAttribute(String, String) |
Zapisuje określony atrybut znaczników i wartość do strumienia wyjściowego. |
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 -> unitPublic 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
altatrybut i jego wartość do<img>elementu.WriteAttribute(String, String, Boolean) Wywołuje przeciążenie w celu renderowania atrybutu niestandardowego
No "encoding" requiredmyattributez wartością , a następnie ustawia wartość .falsefEncodeZamyka 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 "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)
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ż
Dotyczy
.NET Framework 4.8.1 i inne wersje
| Produkt | Wersje |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
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 -> unitPublic 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
altatrybut i jego wartość do<img>elementu.WriteAttribute(String, String, Boolean) Wywołuje przeciążenie w celu renderowania atrybutu niestandardowego
No "encoding" requiredmyattributez wartością , a następnie ustawia wartość .falsefEncodeZamyka 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 "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)
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ż
Dotyczy
.NET Framework 4.8.1 i inne wersje
| Produkt | Wersje |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Opinia o produkcie .NET
.NET to projekt typu open source. Wybierz link, aby przekazać opinię: