HideDisabledControlAdapter.Render(HtmlTextWriter) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt das zugeordnete Websteuerelement als HTML-Code in den Ausgabestream.

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)

Parameter

writer: HtmlTextWriter

Der HtmlTextWriter, der Methoden für die Erstellung und das Rendern der gerätespezifischen Ausgabe enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Render Methode außer Kraft setzen, um das Objekt an das HtmlTextWriter übergeordnete Steuerelement zum Rendern zu übergeben, wenn das zugehörige Steuerelement aktiviert ist. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die HideDisabledControlAdapter Klasse bereitgestellt wird.

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

Hinweise

Die Render Methode schreibt das zugeordnete WebControl Steuerelement in den Ausgabedatenstrom als HTML.

Standardmäßig ruft die .NET Framework die eigene Render Methode des Webserversteuerelements auf. Sobald Adapter die Eigenschaft dieses Steuerelements festgelegt ist, führt die .NET Framework jedoch die Implementierung des Adapters über Render das zugehörige Steuerelement aus.

Das Render Ereignis wird verwendet, um Änderungen an dem Markupcode auszuführen, der in einem Gerätebrowser gerendert wird. Steuerelementeigenschaften sollten vor dieser Phase des Lebenszyklus festgelegt werden und nur die tatsächliche Markuperstellung für das Hier ausgeführte Steuerelement. Änderungen an dem Steuerelement in dieser Phase des Lebenszyklus werden nicht im Ansichtszustand gespeichert. Um Änderungen an dem Steuerelement zu speichern, überschreiben Sie das OnPreRender Ereignis.

Das Render Ereignis ermöglicht auch abgeleiteten Klassen die Behandlung des Ereignisses ohne Anfügen eines Stellvertretungs, was die bevorzugte Technik zum Behandeln des Ereignisses in einer abgeleiteten Klasse ist.

Gilt für

Teilen über