HtmlTextWriter.TagName Propriedade

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 de Propriedade

O nome da etiqueta do elemento de marcação que está a ser renderizado.

Exemplos

O seguinte exemplo de código demonstra uma versão sobreposta do RenderBeforeTag método numa classe que deriva da HtmlTextWriter classe. O exemplo de código verifica se o elemento a renderizar é um <label> elemento chamando o String.Compare método, e depois passando o TagName valor da propriedade e uma cadeia, "label", como argumentos do parâmetro. Se um <label> elemento estiver prestes a ser renderizado, a etiqueta de abertura de um <font> elemento, com um color atributo definido como red, é renderizada antes da <label> etiqueta de abertura do elemento. Se o elemento a renderizar não for um <label> elemento, é chamada a versão RenderBeforeTag do método da classe base.

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

Observações

A TagName propriedade é útil apenas para classes que herdam da HtmlTextWriter classe. Deves ler ou definir a TagName propriedade apenas nas RenderBeginTag chamadas de método; esta é a única altura em que é definida para um valor consistente.

Ver também

• TextWriter
• HtmlTextWriterTag
• RenderBeginTag
• TagKey