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.
Dient zum Abrufen oder Festlegen des HtmlTextWriterTag Werts für das angegebene Markupelement.
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, das das öffnende Tag gerendert hat.
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 ja, wird ein <font> Element mit einem color Attributsatz red 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 wird 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 die einzige Zeit, die auf einen konsistenten Wert festgelegt ist.
