Partager via


HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Méthode

Définition

Détermine si l'élément de balisage spécifié sera rendu sur la page qui a effectué la demande.

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

Paramètres

name
String

Chaîne contenant le nom de l'élément à restituer.

key
HtmlTextWriterTag

HtmlTextWriterTag associé à l'élément.

Retours

Boolean

Toujours true.

Exemples

L’exemple de code suivant montre comment remplacer la OnTagRender méthode. Si un Font élément est affiché, le OnTagRender remplacement utilise la IsAttributeDefined méthode pour déterminer si un Size attribut est rendu. Si ce n’est pas le cas, il utilise la AddAttribute méthode pour créer un Size attribut et définir sa valeur 20ptsur .

// If a <font> element is to be rendered, check whether it contains
// a size attribute. If it does not, add one and set its value to
// 20 points, then return true.
protected override bool OnTagRender(string name, HtmlTextWriterTag key)
{

    if (key == HtmlTextWriterTag.Font)
    {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Size)))
        {
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt");
            return true;
        }
    }

    // If the element is not a <font> element, use
    // the base functionality of the OnTagRenderMethod.
    return base.OnTagRender(name, key);
}
' If a <font> element is to be rendered, check whether it contains
' a size attribute. If it does not, add one and set its value to
' 20 points, then return true.
Protected Overrides Function OnTagRender( _
    name As String, _
    key As HtmlTextWriterTag) _
As Boolean

    If (key = HtmlTextWriterTag.Font) Then
        If Not (IsAttributeDefined(HtmlTextWriterAttribute.Size)) Then
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt")
            Return True
        End If
    End If

    ' If the element is not a <font> element, use
    ' the base functionality of the OnTagRenderMethod.
    Return MyBase.OnTagRender(name, key)
End Function

Remarques

L’implémentation HtmlTextWriter de classe de la OnTagRender méthode retourne truetoujours . Les OnTagRender remplacements peuvent déterminer si un élément sera rendu sur la page.

Notes pour les héritiers

Si vous héritez de la HtmlTextWriter classe, vous pouvez remplacer la OnTagRender(String, HtmlTextWriterTag) méthode pour revenir false pour empêcher le rendu d’un élément de balisage ou pour un langage de balisage particulier. Par exemple, si vous ne souhaitez pas que l’objet dérivé du rendu de HtmlTextWriter l’élément <font> , vous pouvez remplacer la OnTagRender(String, HtmlTextWriterTag) méthode à retourner false lorsqu’une page est demandée qui contient un <font> élément.

S’applique à

Voir aussi