HtmlTextWriter.RenderBeforeTag Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Grava qualquer texto ou espaçamento que ocorre antes da marca de abertura de um elemento de marcação.

protected:
 virtual System::String ^ RenderBeforeTag();

protected virtual string RenderBeforeTag ();

abstract member RenderBeforeTag : unit -> string
override this.RenderBeforeTag : unit -> string

Protected Overridable Function RenderBeforeTag () As String

Retornos

String

O texto ou espaçamento para gravar antes da marca de abertura do elemento de marcação. Se não for substituído, será null.

Exemplos

O exemplo de código a seguir mostra como substituir o RenderBeforeTag método para determinar se uma classe derivada da HtmlTextWriter classe está prestes a renderizar um <label> elemento. Nesse caso, a RenderBeforeTag substituição insere a marca de abertura de um <font> elemento imediatamente antes do <label> elemento. Se ele não estiver renderizando um <label> elemento, o RenderBeforeTag método base será usado.

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

Comentários

O RenderBeforeTag método pode ser útil se você quiser renderizar marcas de abertura adicionais antes da marca de abertura do elemento pretendido.

Notas aos Herdeiros

A HtmlTextWriter implementação de classe do RenderBeforeTag() método retorna null. Substitua RenderBeforeTag() se você quiser escrever texto ou espaçamento antes da marca de abertura do elemento.

Confira também

• TextWriter