HtmlTextWriter.RenderBeforeTag-Methode

Schreibt Text oder Abstände vor dem Starttag eines Markupelements.

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

Syntax

'Declaration
Protected Overridable Function RenderBeforeTag As String
'Usage
Dim returnValue As String

returnValue = Me.RenderBeforeTag

protected virtual string RenderBeforeTag ()

protected:
virtual String^ RenderBeforeTag ()

protected String RenderBeforeTag ()

protected function RenderBeforeTag () : String

Rückgabewert

Der Text oder Abstand, der vor dem Starttag des Markupelements geschrieben werden soll. NULL (Nothing in Visual Basic), wenn die Methode nicht überschrieben wurde.

Hinweise

Die RenderBeforeTag-Methode ist nützlich, wenn Sie vor dem Starttag des gewünschten Elements weitere Starttags rendern möchten.

Hinweise für Implementierer Die HtmlTextWriter-Klassenimplementierung der RenderBeforeTag-Methode gibt NULL (Nothing in Visual Basic) zurück. Überschreiben Sie RenderBeforeTag, wenn Sie Text oder Abstände vor dem Starttag des Elements schreiben möchten.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der RenderBeforeTag-Methode veranschaulicht, um zu bestimmen, ob eine von der HtmlTextWriter-Klasse abgeleitete Klasse ein <label>-Element rendert. Wenn dies der Fall ist, fügt die RenderBeforeTag-Überschreibung direkt vor dem <label>-Element das Starttag eines <font>-Elements ein. Wenn kein <label>-Element gerendert wird, wird die RenderBeforeTag-Basismethode verwendet.

' 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