HtmlTextWriter.RenderBeginTag Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt das öffnende Tag eines Markupelements in den Ausgabedatenstrom.
Überlädt
| Name | Beschreibung |
|---|---|
| RenderBeginTag(String) |
Schreibt das öffnende Tag des angegebenen Markupelements in den Ausgabedatenstrom. |
| RenderBeginTag(HtmlTextWriterTag) |
Schreibt das öffnende Tag des Markupelements, das dem angegebenen HtmlTextWriterTag Enumerationswert zugeordnet ist, in den Ausgabedatenstrom. |
RenderBeginTag(String)
Schreibt das öffnende Tag des angegebenen Markupelements in den Ausgabedatenstrom.
public:
virtual void RenderBeginTag(System::String ^ tagName);public virtual void RenderBeginTag(string tagName);abstract member RenderBeginTag : string -> unit
override this.RenderBeginTag : string -> unitPublic Overridable Sub RenderBeginTag (tagName As String)Parameter
- tagName
- String
Eine Zeichenfolge mit dem Namen des Markupelements, für das das öffnende Tag gerendert werden soll.
Beispiele
Das folgende Codebeispiel zeigt, wie die RenderBeginTag Methode in einem benutzerdefinierten Steuerelement aufgerufen wird, um das öffnende Tag eines nicht standardmäßigen MyTag Elements zu rendern. Anschließend ruft das Codebeispiel 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 nicht einer der HtmlTextWriterTag Enumerationswerte ist.
Um ein Markupelement mithilfe der RenderBeginTag Methode zu generieren, rufen Sie zunächst die AddAttribute Methoden und die AddStyleAttribute Methoden auf, um alle Elementattribute oder Formatattribute 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.
Weitere Informationen
Gilt für:
RenderBeginTag(HtmlTextWriterTag)
Schreibt das öffnende Tag des Markupelements, das dem angegebenen HtmlTextWriterTag Enumerationswert zugeordnet ist, in den Ausgabedatenstrom.
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 -> unitPublic Overridable Sub RenderBeginTag (tagKey As HtmlTextWriterTag)Parameter
- tagKey
- HtmlTextWriterTag
Einer der HtmlTextWriterTag Werte, die das öffnende Tag des zu rendernden Markupelements definieren.
Beispiele
Das folgende Codebeispiel zeigt, wie die RenderBeginTag Methode verwendet wird, um das öffnende Tag eines <img> Elements auszugeben. 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 "Required"" myattribute="No "encoding" 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 einen bekannten Typ aufweist, der eines der HtmlTextWriterTag Enumerationswerte ist.
Um ein Markupelement mithilfe der RenderBeginTag Methode zu generieren, rufen Sie zunächst die AddAttribute Methoden und die AddStyleAttribute Methoden auf, um alle Elementattribute oder Formatattribute 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.