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 qui a effectué la demande. Vous pouvez substituer la méthode OnAttributeRender(String, String, HtmlTextWriterAttribute) dans les classes qui dérivent de la classe ChtmlTextWriter pour éliminer par filtrage les attributs que vous ne souhaitez pas restituer sur des 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 à rendre.

value

String

Valeur à assigner à name.

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute associé à name.

Retours

Boolean

true pour écrire l'attribut et sa valeur dans le flux de sortie ChtmlTextWriter ; 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’écriture de l’attribut bgcolor dans le flux de sortie cHTML. Il appelle ensuite la fonctionnalité fournie par la méthode de base OnAttributeRender à partir 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 l’écriture dans le flux de sortie des attributs supprimés globalement répertoriés dans la GlobalSuppressedAttributes propriété et des attributs supprimés spécifiques à l’élément répertoriés dans la SuppressedAttributes propriété. 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)