HtmlTextWriter.WriteBeginTag-Methode

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

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Sub WriteBeginTag ( _
    tagName As String _
)
'Usage
Dim instance As HtmlTextWriter
Dim tagName As String

instance.WriteBeginTag(tagName)

public virtual void WriteBeginTag (
    string tagName
)

public:
virtual void WriteBeginTag (
    String^ tagName
)

public void WriteBeginTag (
    String tagName
)

public function WriteBeginTag (
    tagName : String
)

Parameter

• tagName
  Das Markupelement, dessen Starttag geschrieben werden soll.

Hinweise

Die WriteBeginTag-Methode schreibt nicht die schließende spitze Klammer (>) für das Starttag des Markupelements. Daher können Markupattribute in das Starttag des Elements geschrieben werden. Mithilfe der TagRightChar-Konstante können Sie beim Aufrufen der WriteBeginTag-Methode das Starttag schließen. Verwenden Sie die WriteBeginTag-Methode mit der SelfClosingTagEnd-Konstante, wenn Sie selbstschließende Markupelemente schreiben.

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

Beispiel

Im folgenden Codebeispiel wird das Rendern eines <img>-Elements veranschaulicht, bei 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 No "encoding" required zu rendern. Anschließend wird fEncode auf false festgelegt.

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

Mit diesem Codebeispiel wird folgendes 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)

// 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);
writer.WriteEndTag("img");

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlTextWriter-Klasse
HtmlTextWriter-Member
System.Web.UI-Namespace
TextWriter
WriteAttribute
TagRightChar
SelfClosingTagEnd
WriteEndTag