HtmlTextWriter.WriteBeginTag(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Zapisuje odstępy między kartami i znacznik otwierający określonego elementu znaczników do strumienia wyjściowego.

public:
 virtual void WriteBeginTag(System::String ^ tagName);
public virtual void WriteBeginTag (string tagName);
abstract member WriteBeginTag : string -> unit
override this.WriteBeginTag : string -> unit
Public Overridable Sub WriteBeginTag (tagName As String)

Parametry

tagName
String

Element znaczników, z którego ma być zapisywany tag otwierający.

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 myattribute z wartością No "encoding" required, a następnie ustawia fEncode wartość na false.

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

Ten przykład kodu generuje następujące adiustacje:

<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

Metoda WriteBeginTag nie zapisuje nawiasu zamykającego kąta (>) tagu otwierającego elementu znaczników. Umożliwia to pisanie atrybutów znaczników do tagu otwierającego elementu. Użyj stałej TagRightChar , aby zamknąć tag otwierający podczas wywoływania WriteBeginTag metody. WriteBeginTag Użyj metody ze stałą SelfClosingTagEnd podczas pisania elementów znaczników, które są samo zamykające.

Metoda WriteBeginTag jest używana przez niestandardowe kontrolki serwera, które nie zezwalają na mapowanie tagów ani atrybutów i renderują elementy znaczników w taki sam sposób dla każdego żądania.

Dotyczy

Zobacz też