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 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 -> unitPublic 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
Gilt für
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 -> unitPublic 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 "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 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.