HtmlTextWriter.TagKey-Eigenschaft

Ruft den HtmlTextWriterTag-Wert für das angegebene Markupelement ab oder legt diesen fest.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Property TagKey As HtmlTextWriterTag
'Usage
Dim value As HtmlTextWriterTag

value = Me.TagKey

Me.TagKey = value

protected HtmlTextWriterTag TagKey { get; set; }

protected:
property HtmlTextWriterTag TagKey {
    HtmlTextWriterTag get ();
    void set (HtmlTextWriterTag value);
}

/** @property */
protected HtmlTextWriterTag get_TagKey ()

/** @property */
protected void set_TagKey (HtmlTextWriterTag value)

protected function get TagKey () : HtmlTextWriterTag

protected function set TagKey (value : HtmlTextWriterTag)

Eigenschaftenwert

Das Markupelement, dessen Starttag gerendert wird.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Der Eigenschaftenwert kann nicht festgelegt werden.

Hinweise

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.

Beispiel

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 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

// 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.

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 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 (get_TagKey().Equals(HtmlTextWriterTag.Label)) {
        return "<font color=\"red\">";
    }
    else {
        return super.RenderBeforeContent();
    }
} //RenderBeforeContent

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlTextWriter-Klasse
HtmlTextWriter-Member
System.Web.UI-Namespace
TextWriter
HtmlTextWriterTag
RenderBeginTag
TagName