XhtmlTextWriter.OnAttributeRender Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Determina se o atributo XHTML especificado e seu valor podem ser renderizados para o elemento atual da marcação.

protected:
 override bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected override bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool

Protected Overrides Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

Parâmetros

name

String

O atributo XHTML a ser renderizado.

value

String

O valor atribuído ao atributo XHTML.

key

HtmlTextWriterAttribute

O valor da enumeração HtmlTextWriterAttribute associado ao atributo XHTML.

Retornos

Boolean

true se o atributo é renderizado para a página; caso contrário, false.

Exemplos

O exemplo de código a seguir demonstra como substituir o OnAttributeRender método para verificar se um atributo é renderizado para qualquer um size dos elementos que são renderizados por este gravador de texto. Se um size atributo for renderizado, o código verificará se seu valor é de 8 pontos. Nesse caso, o OnAttributeRender método retorna true, permitindo que o atributo e seu valor renderizem. Se o valor for diferente de 8 pontos, o OnAttributeRender método retornará falsee o atributo e seu valor não serão renderizados. Se o parâmetro chave do OnAttributeRender método não corresponder ao Size atributo, a funcionalidade base do OnAttributeRender método será chamada, conforme definido na XhtmlTextWriter classe.

Este exemplo de código faz parte de um exemplo maior fornecido para a XhtmlTextWriter classe.

// Override the OnAttributeRender method to 
// allow this text writer to render only eight-point 
// text size.
protected override bool OnAttributeRender(string name, 
  string value, 
  HtmlTextWriterAttribute key) 
{
    if (key == HtmlTextWriterAttribute.Size)
    {
        if (String.Compare(value, "8pt") == 0)
        {
            return true;
        }
        else
        {
           return false;
        } 
     }
     else
     {
         return base.OnAttributeRender(name, value, key);
     }
 }

' Override the OnAttributeRender method to 
' allow this text writer to render only eight-point 
' text size.
Overrides Protected Function OnAttributeRender(ByVal name As String, _
  ByVal value As String, _
  ByVal key As HtmlTextWriterAttribute _
) As Boolean
   If key = HtmlTextWriterAttribute.Size Then
      If String.Compare(value, "8pt") = 0 Then
         Return True
      Else
         Return False
      End If 
   Else
      Return MyBase.OnAttributeRender(name, value, key)
   End If
End Function

Confira também

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)