HtmlTextWriter.TagName Propriedade

  • Referência

Definição

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

Obtém ou define o nome da marca do elemento de marcação que está sendo renderizado.

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

Valor da propriedade

String

O nome da marca do elemento de marcação que está sendo renderizado.

Exemplos

O exemplo de código a seguir demonstra uma versão substituída do RenderBeforeTag método em uma classe derivada da HtmlTextWriter classe. O exemplo de código verifica se o elemento a ser renderizado é um <label> elemento chamando o String.Compare método e, em seguida, passando o valor da TagName propriedade e uma cadeia de caracteres, "label"como os argumentos de parâmetro. Se um <label> elemento estiver prestes a ser renderizado, a marca de abertura de um <font> elemento, com um color atributo definido como red, será renderizada antes da <label> marca de abertura do elemento. Se o elemento a ser renderizado não for um <label> elemento, a versão da classe base do RenderBeforeTag método será chamada.

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

A TagName propriedade é usada apenas para classes que herdam da HtmlTextWriter classe. Você deve ler ou definir a TagName propriedade somente em RenderBeginTag chamadas de método; esta é a única vez que ela é definida como um valor consistente.

Aplica-se a

Confira também