HideDisabledControlAdapter.Render(HtmlTextWriter) Metodo

Definizione

Scrive il controllo Web associato nel flusso di output come HTML.

protected public:
 override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected internal override void Render (System.Web.UI.HtmlTextWriter writer);
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Friend Overrides Sub Render (writer As HtmlTextWriter)

Parametri

writer
HtmlTextWriter

Oggetto HtmlTextWriter contenente i metodi per compilare ed eseguire il rendering dell'output specifico del dispositivo.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override Render del metodo per passare l'oggetto HtmlTextWriter al controllo padre per il rendering se il controllo associato è abilitato. Questo esempio di codice fa parte di un esempio più grande fornito per la HideDisabledControlAdapter classe.

protected override void Render(System.Web.UI.HtmlTextWriter writer)
{
    if (Control.ID.StartsWith("Contoso"))
    {
        if (!Control.Enabled)
        {
            return;
        }
    }

    base.Render(writer);
}
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
    If (Control.ID.StartsWith("Contoso")) Then
        If (Not Control.Enabled) Then
            Return
        End If
    End If

    MyBase.Render(writer)
End Sub

Commenti

Il Render metodo scrive il controllo associato WebControl nel flusso di output come HTML.

Per impostazione predefinita, .NET Framework chiama il proprio Render metodo del controllo server Web. Tuttavia, una volta impostata la Adapter proprietà di tale controllo, .NET Framework eseguirà l'implementazione Render dell'adapter dell'evento su quella del controllo associato.

L'evento Render viene usato per eseguire modifiche al codice di markup sottoposto a rendering in un browser del dispositivo. Le proprietà del controllo devono essere impostate prima di questa fase del ciclo di vita e solo la creazione effettiva del markup per il controllo eseguita qui. Le modifiche apportate al controllo in questa fase del ciclo di vita non vengono salvate per visualizzare lo stato. Per salvare le modifiche apportate al controllo, eseguire l'override dell'evento OnPreRender .

L'evento Render consente anche alle classi derivate di gestire l'evento senza collegare un delegato, ovvero la tecnica preferita per gestire l'evento in una classe derivata.

Si applica a

Vedi anche