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.Determines whether the specified markup element will be rendered to the requesting page.

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.A string containing the name of the element to render.

key
HtmlTextWriterTag

HtmlTextWriterTag associé à l'élément.The HtmlTextWriterTag associated with the element.

Retours

Toujours true.Always true.

Exemples

L’exemple de code suivant montre comment substituer la OnTagRender méthode.The following code example shows how to override the OnTagRender method. Si un Font élément est rendu, la OnTagRender substitution utilise la IsAttributeDefined méthode pour déterminer si un Size attribut est restitué.If a Font element is being rendered, the OnTagRender override uses the IsAttributeDefined method to determine whether a Size attribute is being rendered. Si ce n’est pas le AddAttribute cas, elle utilise Size la méthode pour créer un attribut 20ptet lui affecter la valeur.If not, it uses the AddAttribute method to create a Size attribute and set its value to 20pt.

// 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' HtmlTextWriter implémentation de la classe OnTagRender de la méthode trueretourne toujours.The HtmlTextWriter class implementation of the OnTagRender method always returns true. Les OnTagRender remplacements peuvent déterminer si un élément sera rendu sur la page.The OnTagRender overrides can determine whether an element will be rendered to the page.

Notes pour les héritiers

Si vous héritez de HtmlTextWriter la classe, vous pouvez substituer OnTagRender(String, HtmlTextWriterTag) la méthode pour false retourner pour empêcher qu’un élément de balisage soit rendu du tout ou pour un langage de balisage particulier.If you inherit from the HtmlTextWriter class, you can override the OnTagRender(String, HtmlTextWriterTag) method to return false to prevent a markup element from being rendered at all or for a particular markup language. Par exemple, si vous ne souhaitez pas que HtmlTextWriter l’objet dérivé de pour restitue l' <font> élément, vous pouvez substituer la OnTagRender(String, HtmlTextWriterTag) méthode pour retourner false la valeur quand une page est demandée et contient un <font> élément.For example, if you do not want the object that is derived from HtmlTextWriter to render the <font> element, you can override the OnTagRender(String, HtmlTextWriterTag) method to return false when a page is requested that contains a <font> element.

S’applique à

Voir aussi