HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

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.

Restituisce

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 elemento, l'override usa il OnTagRender metodo per determinare se viene eseguito il IsAttributeDefined rendering di un Font Size attributo. In caso contrario, usa il metodo per creare un Size attributo e impostarne il AddAttribute 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 . Gli OnTagRender overridi possono determinare se verrà eseguito il rendering di un elemento nella pagina.

Note per gli eredi

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

Si applica a

Condividi tramite