ChtmlTextWriter.OnAttributeRender Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Détermine si l’attribut cHTML spécifié et sa valeur sont rendus sur la page demandée. Vous pouvez remplacer la OnAttributeRender(String, String, HtmlTextWriterAttribute) méthode dans les classes qui dérivent de la ChtmlTextWriter classe pour filtrer les attributs que vous ne souhaitez pas afficher sur les appareils qui prennent en charge cHTML.

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

Paramètres

name

String

Attribut cHTML à afficher.

value

String

Valeur affectée à name.

key

HtmlTextWriterAttribute

Associé HtmlTextWriterAttribute à name.

Retours

Boolean

true pour écrire l’attribut et sa valeur dans le ChtmlTextWriter flux de sortie ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser une classe personnalisée qui remplace la OnAttributeRender méthode pour empêcher l’attribut bgcolor d’être écrit dans le flux de sortie cHTML. Il appelle ensuite les fonctionnalités fournies par la méthode de base OnAttributeRender de la ChtmlTextWriter classe pour s’assurer que son comportement par défaut est également utilisé.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la ChtmlTextWriter classe.

// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
    if (String.Equals("bgcolor", name))
    {
        return false;
    }
    
    // Call the ChtmlTextWriter version of the
    // the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is 
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
    If (String.Equals("bgcolor", name)) Then
        Return False
    End If

    ' Call the ChtmlTextWriter version of 
    ' the OnAttributeRender method.
    MyBase.OnAttributeRender(name, value, key)

End Function

Remarques

Par défaut, la OnAttributeRender méthode empêche les attributs globalement supprimés répertoriés dans la GlobalSuppressedAttributes propriété et les attributs spécifiques à l’élément qui sont répertoriés dans la SuppressedAttributes propriété d’être écrits dans le flux de sortie. Vous pouvez remplacer le comportement de la OnAttributeRender méthode dans les classes dérivées de la ChtmlTextWriter classe.

Voir aussi

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)