HtmlTextWriter.OnAttributeRender(String, String, HtmlTextWriterAttribute) Método
Definição
Determina se o atributo de marcação especificado e seu valor podem ser renderizados para o elemento atual da marcação.Determines whether the specified markup attribute and its value can be rendered to the current markup element.
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.A string containing the name of the attribute to render.
- value
- String
Uma cadeia de caracteres que contém o valor atribuído ao atributo.A string containing the value that is assigned to the attribute.
O HtmlTextWriterAttribute associado ao atributo de marcação.The HtmlTextWriterAttribute associated with the markup attribute.
Retornos
Sempre true.Always true.
Exemplos
O exemplo de código a seguir mostra como substituir o OnAttributeRender método.The following code example shows how to override the OnAttributeRender method. Se um Size atributo for renderizado, mas o Size valor não for 30pt , 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 rendered, but the Size value is not 30pt, the OnAttributeRender override calls the AddAttribute method to add a Size attribute and set its value to 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 .The HtmlTextWriter class implementation of the OnAttributeRender method always returns true. As OnAttributeRender substituições podem determinar se um atributo será renderizado para a página.The OnAttributeRender overrides can determine whether an attribute will be rendered to the page.
Notas aos Herdeiros
Se você herdar da HtmlTextWriter classe, poderá substituir o OnAttributeRender(String, String, HtmlTextWriterAttribute) método a ser retornado false para impedir que um atributo seja renderizado, sendo renderizado em um determinado elemento ou sendo renderizado para uma marcação específica.If you inherit from the HtmlTextWriter class, you can override the OnAttributeRender(String, String, HtmlTextWriterAttribute) method to return false to prevent an attribute from being rendered at all, being rendered on a particular element, or being rendered for a particular markup. Por exemplo, se você não quiser que o objeto derivado de HtmlTextWriter para renderizar o bgcolor atributo em <table> elementos, você poderá substituir OnAttributeRender(String, String, HtmlTextWriterAttribute) e retornar false quando name passar bgcolor e o TagName valor da propriedade for table .For example, if you do not want the object derived from HtmlTextWriter to render the bgcolor attribute to <table> elements, you can override the OnAttributeRender(String, String, HtmlTextWriterAttribute) and return false when name passes bgcolor and the TagName property value is table.