HtmlTextWriter.TagName Eigenschaft

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

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

protected string TagName { get; set; }

member this.TagName : string with get, set

Protected Property TagName As String

Eigenschaftswert

String

Der Tagname des gerenderten Markupelements.

Beispiele

Im folgenden Codebeispiel wird eine überschriebene Version der RenderBeforeTag -Methode in einer Klasse veranschaulicht, die von der HtmlTextWriter -Klasse abgeleitet wird. Im Codebeispiel wird überprüft, "label"ob das zu renderde Element ein <label> Element ist, indem die String.Compare -Methode aufgerufen und dann der TagName Eigenschaftswert und die Zeichenfolge als Parameterargumente übergeben werden. Wenn ein <label> Element gerendert werden soll, wird das öffnende Tag eines <font> Elements, dessen color Attribut auf redfestgelegt ist, vor dem <label> öffnenden Tag des Elements gerendert. Wenn das zu renderde Element kein <label> Element ist, wird die Version der -Methode der RenderBeforeTag 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.
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 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. 
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

Hinweise

Die TagName -Eigenschaft wird nur für Klassen verwendet, die von der -Klasse erben HtmlTextWriter . Sie sollten die TagName Eigenschaft nur in RenderBeginTag Methodenaufrufen lesen oder festlegen. Dies ist das einzige Mal, dass sie auf einen konsistenten Wert festgelegt wird.

Weitere Informationen

• TextWriter
• HtmlTextWriterTag
• RenderBeginTag
• TagKey