HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Metodo

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Determina se il rendering dell'elemento di markup specificato verrà eseguito nella pagina di richiesta.

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

Stringa contenente il nome dell'elemento di cui eseguire il rendering.

key
HtmlTextWriterTag

Oggetto HtmlTextWriterTag associato all'elemento .

Valori restituiti

Boolean

Sempre true.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del OnTagRender metodo . Se viene eseguito il rendering di un Font elemento, l'override OnTagRender usa il metodo per determinare se viene eseguito il IsAttributeDefined rendering di un Size attributo. In caso contrario, usa il AddAttribute metodo per creare un Size attributo e impostarne il valore su 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'implementazione HtmlTextWriter della classe del OnTagRender metodo restituisce truesempre . Le OnTagRender sostituzioni possono determinare se verrà eseguito il rendering di un elemento nella pagina.

Note per gli eredi

Se si eredita dalla HtmlTextWriter classe , è possibile eseguire l'override del OnTagRender(String, HtmlTextWriterTag) metodo per restituire false per impedire il rendering di un elemento di markup o per un particolare linguaggio di markup. Ad esempio, se non si desidera che l'oggetto derivato da HtmlTextWriter per eseguire il rendering dell'elemento, è possibile eseguire l'override <font> del OnTagRender(String, HtmlTextWriterTag) metodo per restituire false quando viene richiesta una pagina contenente un <font> elemento .

Si applica a

Vedi anche