ChtmlTextWriter.OnAttributeRender Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Determina se viene eseguito il rendering dell'attributo cHTML specificato e del relativo valore nella pagina in cui viene sottoposta la richiesta. È possibile eseguire l'override del metodo OnAttributeRender(String, String, HtmlTextWriterAttribute) nelle classi che derivano dalla classe ChtmlTextWriter per escludere gli attributi di cui non si desidera eseguire il rendering in dispositivi che supportano cHTML.

protected:
 override bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected override bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool

Protected Overrides Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

Parametri

name

String

Attributo cHTML di cui eseguire il rendering.

value

String

Valore assegnato a name.

key

HtmlTextWriterAttribute

Elemento HtmlTextWriterAttribute associato a name.

Restituisce

Boolean

true per scrivere l'attributo e il relativo valore nel flusso di output di ChtmlTextWriter. In caso contrario, false.

Esempio

Nell'esempio di codice seguente viene illustrato come usare una classe personalizzata che esegue l'override del OnAttributeRender metodo per impedire che l'attributo bgcolor venga scritto nel flusso di output cHTML. Chiama quindi la funzionalità fornita dal metodo di base OnAttributeRender dalla ChtmlTextWriter classe per assicurarsi che venga usato anche il relativo comportamento predefinito.

Questo esempio di codice fa parte di un esempio più grande fornito per la ChtmlTextWriter classe.

// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
    if (String.Equals("bgcolor", name))
    {
        return false;
    }
    
    // Call the ChtmlTextWriter version of the
    // the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is 
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
    If (String.Equals("bgcolor", name)) Then
        Return False
    End If

    ' Call the ChtmlTextWriter version of 
    ' the OnAttributeRender method.
    MyBase.OnAttributeRender(name, value, key)

End Function

Commenti

Per impostazione predefinita, il OnAttributeRender metodo impedisce agli attributi eliminati a livello globale elencati nella GlobalSuppressedAttributes proprietà e nello specifico degli elementi, eliminati attributi elencati nella SuppressedAttributes proprietà da scrivere nel flusso di output. È possibile eseguire l'override OnAttributeRender del comportamento del metodo nelle classi derivate dalla ChtmlTextWriter classe.

Vedi anche

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)