HtmlTextWriter.TagKey-Eigenschaft

Die TagKey-Eigenschaft kann nur von Klassen verwendet werden, die von der HtmlTextWriter-Klasse vererbt werden. Sie sollten die TagKey-Eigenschaft nur bei einem Aufruf der RenderBeginTag-Methode lesen bzw. festlegen. Nur in diesem Fall wird sie auf einen konsistenten Wert festgelegt.

Im folgenden Codebeispiel wird eine überschriebene Version der RenderBeforeContent-Methode in einer Klasse veranschaulicht, die von der HtmlTextWriter-Klasse abgeleitet ist. Sie bestimmt anhand des Werts der TagKey-Eigenschaft, ob ein Serversteuerelement mithilfe eines benutzerdefinierten HtmlTextWriter-Objekts ein <label>-Markupelement rendert. Wenn dies der Fall ist, wird ein <font>-Element mit einem auf red festgelegten color-Attribut zurückgegeben, um die Formatierung des Textes des <label>-Elements zu ändern.

// 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();
    }
}

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz