HtmlTextWriter.TagName-Eigenschaft

Ruft den Tagnamen des gerenderten Markupelements ab oder legt diesen fest.

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

Syntax

'Declaration
Protected Property TagName As String
'Usage
Dim value As String

value = Me.TagName

Me.TagName = value

protected string TagName { get; set; }

protected:
property String^ TagName {
    String^ get ();
    void set (String^ value);
}

/** @property */
protected String get_TagName ()

/** @property */
protected void set_TagName (String value)

protected function get TagName () : String

protected function set TagName (value : String)

Eigenschaftenwert

Der Tagname des gerenderten Markupelements.

Hinweise

Die TagName-Eigenschaft kann nur von Klassen verwendet werden, die von der HtmlTextWriter-Klasse vererbt werden. Sie sollten die TagName-Eigenschaft nur bei Aufrufen 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 RenderBeforeTag-Methode in einer Klasse veranschaulicht, die von der HtmlTextWriter-Klasse abgeleitet ist. Im Codebeispiel wird geprüft, ob das zu rendernde Element ein <label>-Element ist, indem die String.Compare-Methode aufgerufen und der TagName-Eigenschaftenwert und die Zeichenfolge "label" als die Parameterargumente übergeben werden. Wenn ein <label>-Element gerendert werden soll, wird vor dem Starttag des <label>-Elements das Starttag eines <font>-Elements gerendert, dessen color-Attribut auf red festgelegt ist. Wenn das zu rendernde Element kein <label>-Element ist, wird die RenderBeforeTag-Methode der Basisklasse aufgerufen.

' Override the RenderBeforeTag method to add the 
' opening tag of a Font element before the 
' opening tag of any Label elements rendered by this 
' custom markup writer. 
Protected Overrides Function RenderBeforeTag() As String
    ' Compare the TagName property value to the
    ' string label to determine whether the element to 
    ' be rendered is a Label. If it is a Label,
    ' the opening tag of the Font element, with a Color
    ' style attribute set to red, is added before
    ' the Label.
    If String.Compare(TagName, "label") = 0 Then
        Return "<font color=""red"">"
        ' If a Label is not being rendered, use 
        ' the base RenderBeforeTag method.
    Else
        Return MyBase.RenderBeforeTag()
    End If
End Function 'RenderBeforeTag

// Override the RenderBeforeTag method to add the 
// opening tag of a Font element before the 
// opening tag of any Label elements rendered by this 
// custom markup writer. 
protected override string RenderBeforeTag()
{
    // Compare the TagName property value to the
    // string label to determine whether the element to 
    // be rendered is a Label. If it is a Label,
    // the opening tag of the Font element, with a Color
    // style attribute set to red, is added before
    // the Label.
    if (String.Compare(TagName, "label") == 0)
    {
        return "<font color=\"red\">";
    }
    // If a Label is not being rendered, use 
        // the base RenderBeforeTag method.
    else
    {
        return base.RenderBeforeTag();
    }
}

// Override the RenderBeforeTag method to add the
// opening tag of a Font element before the
// opening tag of any Label elements rendered by this
// custom markup writer.
virtual String^ RenderBeforeTag() override
{
   // Compare the TagName property value to the
   // String* label to determine whether the element to
   // be rendered is a Label. If it is a Label,
   // the opening tag of the Font element, with a Color
   // style attribute set to red, is added before
   // the Label.
   if ( String::Compare( TagName, "label" ) == 0 )
   {
      return "<font color=\"red\">";
   }
   // If a Label is not being rendered, use
   // the base RenderBeforeTag method.
   else
   {
      return __super::RenderBeforeTag();
   }
}

// Override the RenderBeforeTag method to add the 
// opening tag of a Font element before the 
// opening tag of any Label elements rendered by this 
// custom markup writer. 
protected String RenderBeforeTag()
{
    // Compare the TagName property value to the
    // string label to determine whether the element to 
    // be rendered is a Label. If it is a Label,
    // the opening tag of the Font element, with a Color
    // style attribute set to red, is added before
    // the Label.
    if (String.Compare(get_TagName(), "label") == 0) {
        return "<font color=\"red\">";
    }
        // If a Label is not being rendered, use 
        // the base RenderBeforeTag method.
    else  {
        return super.RenderBeforeTag();
    }
} //RenderBeforeTag

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
HtmlTextWriter.TagKey-Eigenschaft