HtmlTextWriter.WriteBeginTag(String) Method

Definition

Schreibt alle Tabstopps und das Starttag des angegebenen Markupelements in den Ausgabestream.Writes any tab spacing and the opening tag of the specified markup element to the output stream.

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)

Parameters

tagName
String

Das Markupelement, dessen Starttag geschrieben werden soll.The markup element of which to write the opening tag.

Examples

Das folgende Codebeispiel veranschaulicht das Rendern eines <img>-Elements, in dem beide über Ladungen der WriteAttribute-Methode aufgerufen werden.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. Das Codebeispiel verwendet den folgenden Prozess:The code example uses the following process:

  • Ruft die WriteBeginTag-Methode auf, die die öffnenden Zeichen des-Elements rendert.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Ruft die WriteAttribute(String, String)-Überladung auf, die ein alt Attribut und seinen Wert in das <img>-Element schreibt.Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • Ruft die WriteAttribute(String, String, Boolean)-Überladung auf, um ein benutzerdefiniertes myattribute Attribut mit dem Wert No "encoding" requiredzu erzeugen, und legt dann fEncode auf falsefest.Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Schließt das öffnende Tag des Elements und ruft dann die WriteEndTag-Methode auf, um das <img> Element zu schließen.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

In diesem Codebeispiel wird das folgende Markup generiert:This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Remarks

Die WriteBeginTag-Methode schreibt nicht die schließende spitze Klammer (>) des öffnenden Tags des Markup Elements.The WriteBeginTag method does not write the closing angle bracket (>) of the markup element's opening tag. Dies ermöglicht das Schreiben von Markup Attributen in das öffnende Tag des Elements.This allows the writing of markup attributes to the opening tag of the element. Verwenden Sie die TagRightChar Konstante, um das öffnende Tag zu schließen, wenn Sie die WriteBeginTag-Methode aufrufen.Use the TagRightChar constant to close the opening tag when calling the WriteBeginTag method. Verwenden Sie die WriteBeginTag-Methode mit der SelfClosingTagEnd-Konstante, wenn Sie Markup Elemente schreiben, die sich selbst schließen.Use the WriteBeginTag method with the SelfClosingTagEnd constant when you write markup elements that are self-closing.

Die WriteBeginTag-Methode wird von benutzerdefinierten Server Steuerelementen verwendet, die keine Tags-oder Attribut Zuordnung und Rendering-Markup Elemente auf die gleiche Weise für jede Anforderung zulassen.The WriteBeginTag method is used by custom server controls that do not allow tag or attribute mapping and render markup elements in the same way for each request.

Applies to

See also