Freigeben über


HtmlTextWriter.WriteBeginTag(String) Methode

Definition

Schreibt alle Tabstopps und das Starttag des angegebenen Markupelements in den Ausgabestream.

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)

Parameter

tagName
String

Das Markupelement, dessen Starttag geschrieben werden soll.

Beispiele

Im folgenden Codebeispiel wird das Rendern eines <img> Elements veranschaulicht, in dem beide Überladungen der WriteAttribute -Methode aufgerufen werden. Im Codebeispiel wird der folgende Prozess verwendet:

  • Ruft die WriteBeginTag -Methode auf, die die öffnenden Zeichen des Elements rendert.

  • Ruft die WriteAttribute(String, String) Überladung auf, die ein alt Attribut und dessen Wert in das <img> -Element schreibt.

  • Ruft die WriteAttribute(String, String, Boolean) Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit dem Wert zu No "encoding" requiredrendern, und legt dann auf fest fEncodefalse.

  • Schließt das öffnende Tag des Elements und ruft dann die WriteEndTag -Methode auf, um das <img> Element zu schließen.

In diesem Codebeispiel wird das folgende Markup generiert:

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

Hinweise

Die WriteBeginTag -Methode schreibt nicht die schließende eckige Klammer (>) des öffnenden Tags des Markupelements. Dies ermöglicht das Schreiben von Markupattributen in das öffnende Tag des Elements. Verwenden Sie die TagRightChar Konstante, um das öffnende Tag beim Aufrufen der WriteBeginTag -Methode zu schließen. Verwenden Sie die WriteBeginTag -Methode mit der SelfClosingTagEnd Konstante, wenn Sie Markupelemente schreiben, die sich selbst schließen.

Die WriteBeginTag -Methode wird von benutzerdefinierten Serversteuerelementen verwendet, die keine Tag- oder Attributzuordnung zulassen und Markupelemente für jede Anforderung auf die gleiche Weise rendern.

Gilt für:

Weitere Informationen