HtmlTextWriter.TagKey Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Obtiene o establece el valor de HtmlTextWriterTag para el elemento de marcado especificado.

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

Valor de propiedad

HtmlTextWriterTag

Elemento de marcado cuya etiqueta de apertura se va a representar.

Excepciones

ArgumentOutOfRangeException

No se puede establecer este valor de propiedad.

Ejemplos

En el ejemplo de código siguiente se muestra una versión invalidada del RenderBeforeContent método en una clase que deriva de la HtmlTextWriter clase . Usa el valor de la TagKey propiedad para determinar si un control de servidor mediante el objeto personalizado HtmlTextWriter representa un <label> elemento de marcado. Si es así, se devuelve un <font> elemento con un color atributo establecido red en para modificar el formato del <label> texto del elemento.

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

Comentarios

La TagKey propiedad es de uso solo para las clases que heredan de la HtmlTextWriter clase . Debe leer o establecer la TagKey propiedad solo en una llamada al RenderBeginTag método ; es la única vez que se establece en un valor coherente.

Se aplica a

Consulte también