HtmlTextWriter.OnAttributeRender Método

  • Referência

Definição

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

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

protected:
 virtual bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);
protected virtual bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);
abstract member OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
Protected Overridable Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

Parâmetros

name
String

Uma cadeia de caracteres que contém o nome do atributo a renderizar.

value
String

Uma cadeia de caracteres que contém o valor atribuído ao atributo.

key
HtmlTextWriterAttribute

O HtmlTextWriterAttribute associado ao atributo de marcação.

Retornos

Boolean

Sempre true.

Exemplos

O exemplo de código a seguir mostra como substituir o OnAttributeRender método. Se um Size atributo for renderizado, mas o Size valor não 30ptfor, a OnAttributeRender substituição chamará o AddAttribute método para adicionar um Size atributo e definir seu valor como 30pt.

// If a size attribute is to be rendered, compare its value to 30 point.
// If it is not set to 30 point, add the attribute and set the value to 30,
// then return false.
protected override bool OnAttributeRender(string name,
    string value,
    HtmlTextWriterAttribute key)
{

    if (key == HtmlTextWriterAttribute.Size)
    {
        if (string.Compare(value, "30pt") != 0)
        {
            AddAttribute("size", "30pt");
            return false;
        }
    }

    // If the attribute is not a size attribute, use
    // the base functionality of the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' If a size attribute is to be rendered, compare its value to 30 point.
' If it is not set to 30 point, add the attribute and set the value to 30
' then return false.
Protected Overrides Function OnAttributeRender(name As String, _
    value As String, _
    key As HtmlTextWriterAttribute) _
As Boolean

    If key = HtmlTextWriterAttribute.Size Then
        If [String].Compare(value, "30pt") <> 0 Then
            AddAttribute("size", "30pt")
            Return False
        End If
    End If

    ' If the attribute is not a size attribute, use
    ' the base functionality of the OnAttributeRender method.
    Return MyBase.OnAttributeRender(name, value, key)
End Function 'OnAttributeRender

Comentários

A HtmlTextWriter implementação de classe do OnAttributeRender método sempre retorna true. As OnAttributeRender substituições podem determinar se um atributo será renderizado na página.

Notas aos Herdeiros

Se você herdar da HtmlTextWriter classe, poderá substituir o OnAttributeRender(String, String, HtmlTextWriterAttribute) método para retornar false para impedir que um atributo seja renderizado, ser renderizado em um determinado elemento ou ser renderizado para uma marcação específica. Por exemplo, se você não quiser que o objeto derivado renderize o bgcolor atributo para <table> elementos, você poderá substituir e OnAttributeRender(String, String, HtmlTextWriterAttribute) retornar false quando name passar bgcolor e o valor da TagName propriedade for table.HtmlTextWriter

Aplica-se a

Confira também