HtmlTextWriter.TagName Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

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.

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.

Gilt für:

Produkt	Versionen
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Freigeben über