ChtmlTextWriter.OnAttributeRender Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Determina se il rendering dell'attributo cHTML specificato e del relativo valore viene eseguito nella pagina di richiesta. È possibile eseguire l'override del OnAttributeRender(String, String, HtmlTextWriterAttribute) metodo nelle classi che derivano dalla ChtmlTextWriter classe per escludere gli attributi di cui non si vuole eseguire il rendering nei 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

Oggetto HtmlTextWriterAttribute associato a name.

Restituisce

Boolean

true per scrivere l'attributo e il relativo valore nel ChtmlTextWriter flusso di output; 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 comportamento predefinito.

Questo esempio di codice fa parte di un esempio più ampio 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 che gli attributi eliminati a livello globale elencati nella GlobalSuppressedAttributes proprietà e gli attributi specifici degli elementi elencati nella SuppressedAttributes proprietà vengano scritti nel flusso di output. È possibile eseguire l'override del comportamento del OnAttributeRender metodo nelle classi derivate dalla ChtmlTextWriter classe .

Vedi anche

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)