HtmlTextWriter.TagKey Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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

protected:
 property System::Web::UI::HtmlTextWriterTag TagKey { System::Web::UI::HtmlTextWriterTag get(); void set(System::Web::UI::HtmlTextWriterTag value); };
protected System.Web.UI.HtmlTextWriterTag TagKey { get; set; }
member this.TagKey : System.Web.UI.HtmlTextWriterTag with get, set
Protected Property TagKey As HtmlTextWriterTag

Eigenschaftswert

HtmlTextWriterTag

Das Markupelement, dessen Starttag gerendert wird.

Ausnahmen

ArgumentOutOfRangeException

Der Eigenschaftswert kann nicht festgelegt werden.

Beispiele

Im folgenden Codebeispiel wird eine überschriebene Version der RenderBeforeContent Methode in einer Klasse veranschaulicht, die von der HtmlTextWriter Klasse abgeleitet wird. Es verwendet den Wert der TagKey Eigenschaft, um zu bestimmen, ob ein Serversteuerelement mit dem benutzerdefinierten HtmlTextWriter Objekt ein <label> Markupelement rendert. Wenn es sich um ein <font> Element mit einem color Attributsatz red handelt, wird zurückgegeben, um die Formatierung des Texts des <label> Elements zu ändern.

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

Hinweise

Die TagKey Eigenschaft ist nur für Klassen verwendet, die von der HtmlTextWriter Klasse erben. Sie sollten die TagKey Eigenschaft nur in einem Aufruf der RenderBeginTag Methode lesen oder festlegen. Dies ist das einzige Mal, wenn sie auf einen konsistenten Wert festgelegt ist.

Gilt für

Siehe auch