HideDisabledControlAdapter.Render(HtmlTextWriter) Metodo
Definizione
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.
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.