HtmlTextWriter.TagKey Eigenschaft
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.
Ruft den HtmlTextWriterTag-Wert für das angegebene Markupelement ab oder legt diesen fest.
protected:
property System::Web::UI::HtmlTextWriterTag TagKey { System::Web::UI::HtmlTextWriterTag get(); void set(System::Web::UI::HtmlTextWriterTag value); };protected System.Web.UI.HtmlTextWriterTag TagKey { get; set; }member this.TagKey : System.Web.UI.HtmlTextWriterTag with get, setProtected Property TagKey As HtmlTextWriterTagEigenschaftswert
Das Markupelement, dessen Starttag gerendert wird.
Ausnahmen
Der Eigenschaftswert kann nicht festgelegt werden.
Beispiele
Im folgenden Codebeispiel wird eine überschriebene Version der RenderBeforeContent Methode in einer Klasse veranschaulicht, die von der HtmlTextWriter Klasse abgeleitet wird. Es verwendet den Wert der TagKey Eigenschaft, um zu bestimmen, ob ein Serversteuerelement mit dem benutzerdefinierten HtmlTextWriter Objekt ein <label> Markupelement rendert. Wenn es sich um ein <font> Element mit einem color Attributsatz red handelt, wird zurückgegeben, um die Formatierung des Texts des <label> Elements zu ändern.
// Override the RenderBeforeContent method to write
// a font element that applies red to the text in a Label element.
virtual String^ RenderBeforeContent() override
{
// Check to determine whether the element being rendered
// is a label element. If so, render the opening tag
// of the font element; otherwise, call the base method.
if ( TagKey == HtmlTextWriterTag::Label )
{
return "<font color=\"red\">";
}
else
{
return __super::RenderBeforeContent();
}
}
// Override the RenderBeforeContent method to write
// a font element that applies red to the text in a Label element.
protected override string RenderBeforeContent()
{
// Check to determine whether the element being rendered
// is a label element. If so, render the opening tag
// of the font element; otherwise, call the base method.
if (TagKey == HtmlTextWriterTag.Label)
{
return "<font color=\"red\">";
}
else
{
return base.RenderBeforeContent();
}
}
' Override the RenderBeforeContent method to write
' a font element that applies red to the text in a Label element.
Protected Overrides Function RenderBeforeContent() As String
' Check to determine whether the element being rendered
' is a label element. If so, render the opening tag
' of the font element; otherwise, call the base method.
If TagKey = HtmlTextWriterTag.Label Then
Return "<font color=""red"">"
Else
Return MyBase.RenderBeforeContent()
End If
End Function 'RenderBeforeContent
Hinweise
Die TagKey Eigenschaft ist nur für Klassen verwendet, die von der HtmlTextWriter Klasse erben. Sie sollten die TagKey Eigenschaft nur in einem Aufruf der RenderBeginTag Methode lesen oder festlegen. Dies ist das einzige Mal, wenn sie auf einen konsistenten Wert festgelegt ist.