HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Method

Definizione

Determina se verrà eseguito il rendering dell'elemento di markup specificato nella pagina richiedente.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

Parametri

name
String String String String

Stringa contenente il nome dell'elemento di cui eseguire il rendering.A string containing the name of the element to render.

key
HtmlTextWriterTag HtmlTextWriterTag HtmlTextWriterTag HtmlTextWriterTag

Oggetto HtmlTextWriterTag associato all'elemento.The HtmlTextWriterTag associated with the element.

Restituisce

Sempre true.Always true.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato OnTagRender come eseguire l'override del metodo.The following code example shows how to override the OnTagRender method. Se viene Font eseguito il rendering di un elemento OnTagRender , l'override IsAttributeDefined usa il metodo per determinare Size se viene eseguito il rendering di un attributo.If a Font element is being rendered, the OnTagRender override uses the IsAttributeDefined method to determine whether a Size attribute is being rendered. In caso contrario, viene utilizzato AddAttribute il metodo per creare Size un attributo e impostarne il 20ptvalore su.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

Commenti

L' HtmlTextWriter true implementazioneOnTagRender della classe del metodo restituisce sempre.The HtmlTextWriter class implementation of the OnTagRender method always returns true. Le OnTagRender sostituzioni possono determinare se verrà eseguito il rendering di un elemento nella pagina.The OnTagRender overrides can determine whether an element will be rendered to the page.

Note per gli eredi

Se si eredita dalla HtmlTextWriter classe, è possibile eseguire l'override del OnTagRender(String, HtmlTextWriterTag) metodo per false restituire per impedire che venga eseguito il rendering di un elemento di markup o per un particolare linguaggio di markup.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. Se, ad esempio, non si desidera che l'oggetto derivato HtmlTextWriter da esegua il rendering dell' <font> elemento, è possibile eseguire OnTagRender(String, HtmlTextWriterTag) l'override del false metodo da restituire quando viene richiesta una pagina <font> che contiene un elemento.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.

Si applica a

Vedi anche