HtmlTextWriter.RenderBeginTag Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Schreibt das Starttag eines Markupelements in den Ausgabestream.

Überlädt

RenderBeginTag(String)	Schreibt das Starttag des angegebenen Markupelements in den Ausgabestream.
RenderBeginTag(HtmlTextWriterTag)	Schreibt das Starttag des Markupelements, das dem angegebenen HtmlTextWriterTag-Enumerationswert zugeordnet ist, in den Ausgabestream.

RenderBeginTag(String)

Schreibt das Starttag des angegebenen Markupelements in den Ausgabestream.

public:
 virtual void RenderBeginTag(System::String ^ tagName);

public virtual void RenderBeginTag (string tagName);

abstract member RenderBeginTag : string -> unit
override this.RenderBeginTag : string -> unit

Public Overridable Sub RenderBeginTag (tagName As String)

Parameter

tagName

String

Eine Zeichenfolge mit dem Namen der Markupelements, für das das Starttag gerendert wird.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die RenderBeginTag Methode in einem benutzerdefinierten Steuerelement aufrufen, um das öffnende Tag eines nicht standardmäßigen MyTag Elements zu rendern. Das Codebeispiel ruft dann die Write Methode zum Rendern des inneren Markups auf, und ruft dann die RenderEndTag Methode auf, um das Element zu schließen.

In diesem Codebeispiel wird das folgende Markup generiert:

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();

// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();

' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

Hinweise

Verwenden Sie die RenderBeginTag Außerkraftsetzung der RenderBeginTag(String) Methode, wenn das Markupelement keine der HtmlTextWriterTag Enumerationswerte ist.

Um ein Markupelement mithilfe der RenderBeginTag Methode zu generieren, rufen Sie zunächst die AddAttribute AddStyleAttribute Methoden auf, um alle Elementattribute oder Formatvorlagenattribute anzugeben, die im öffnenden Tag des Elements angezeigt werden sollen. Rufen Sie nach dem Generieren des inneren Markups die RenderEndTag Methode auf, um das schließende Tag zu generieren.

Siehe auch

• TextWriter
• AddAttribute
• AddStyleAttribute
• RenderEndTag()

RenderBeginTag(HtmlTextWriterTag)

Schreibt das Starttag des Markupelements, das dem angegebenen HtmlTextWriterTag-Enumerationswert zugeordnet ist, in den Ausgabestream.

public:
 virtual void RenderBeginTag(System::Web::UI::HtmlTextWriterTag tagKey);

public virtual void RenderBeginTag (System.Web.UI.HtmlTextWriterTag tagKey);

abstract member RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
override this.RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit

Public Overridable Sub RenderBeginTag (tagKey As HtmlTextWriterTag)

Parameter

tagKey

HtmlTextWriterTag

Einer der HtmlTextWriterTag-Werte, der das Starttag des zu rendernden Markupelements definiert.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die RenderBeginTag Methode zum Ausgeben des öffnenden Tags eines <img> Elements verwendet wird. Die Attribute, die dem Element durch die AddAttribute Methode hinzugefügt werden, befinden sich im öffnenden <img> Tag. Die RenderEndTag Methode wird verwendet, um das schließende Tag zu generieren.

In diesem Codebeispiel wird das folgende Markup generiert:

<img alt="Encoding &quot;Required&quot;" myattribute="No &quot;encoding&quot; required">

</img>

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Hinweise

Verwenden Sie die RenderBeginTag Überladung der RenderBeginTag(HtmlTextWriterTag) Methode, wenn das Markupelement eines bekannten Typs ist, der eines der HtmlTextWriterTag Enumerationswerte ist.

Um ein Markupelement mithilfe der RenderBeginTag Methode zu generieren, rufen Sie zunächst die AddAttribute AddStyleAttribute Methoden auf, um alle Elementattribute oder Formatvorlagenattribute anzugeben, die im öffnenden Tag des Elements angezeigt werden sollen. Rufen Sie nach dem Generieren des inneren Markups die RenderEndTag Methode auf, um das schließende Tag zu generieren.

Siehe auch

• TextWriter
• AddAttribute
• AddStyleAttribute
• RenderEndTag()