Partager via


HtmlTextWriter.OnAttributeRender Méthode

Définition

Détermine si l'attribut de balisage spécifié et sa valeur peuvent être rendus dans l'élément de balisage actuel.

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

Paramètres

name
String

Chaîne qui contient le nom de l'attribut à restituer.

value
String

Chaîne contenant la valeur assignée à l'attribut.

key
HtmlTextWriterAttribute

HtmlTextWriterAttribute associé à l'attribut de balisage.

Retours

Toujours true.

Exemples

L’exemple de code suivant montre comment remplacer la OnAttributeRender méthode . Si un Size attribut est rendu, mais que la Size valeur n’est pas 30pt, le OnAttributeRender remplacement appelle la AddAttribute méthode pour ajouter un Size attribut et définir sa valeur sur 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

Remarques

L’implémentation HtmlTextWriter de classe de la OnAttributeRender méthode retourne truetoujours . Les OnAttributeRender remplacements peuvent déterminer si un attribut sera restitué à la page.

Notes pour les héritiers

Si vous héritez de la HtmlTextWriter classe, vous pouvez remplacer la OnAttributeRender(String, String, HtmlTextWriterAttribute) méthode à retourner false pour empêcher le rendu d’un attribut, d’être rendu sur un élément particulier ou d’être rendu pour un balisage particulier. Par exemple, si vous ne souhaitez pas que l’objet dérivé de HtmlTextWriter rende l’attribut bgcolor aux <table> éléments, vous pouvez remplacer et OnAttributeRender(String, String, HtmlTextWriterAttribute) retourner false lorsque passe bgcolor et que name la valeur de la TagName propriété est table.

S’applique à

Voir aussi