HideDisabledControlAdapter.Render(HtmlTextWriter) Methode
Definition
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 in den Ausgabedatenstrom.
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 -> unitProtected Friend Overrides Sub Render (writer As HtmlTextWriter)Parameter
- writer
- HtmlTextWriter
Die HtmlTextWriter enthaltenden Methoden zum Erstellen und Rendern der gerätespezifischen Ausgabe.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Render Methode überschreibt, um das HtmlTextWriter Objekt zum Rendern an das übergeordnete Steuerelement zu übergeben, wenn das zugeordnete 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 als HTML in den Ausgabedatenstrom.
Standardmäßig ruft .NET Framework die eigene Render Methode des Webserversteuerelements auf. Sobald die Adapter Eigenschaft dieses Steuerelements festgelegt ist, führt .NET Framework jedoch die Implementierung des Render Ereignisses über das des zugeordneten Steuerelements aus.
Das Render Ereignis wird verwendet, um Änderungen am Markupcode durchzuführen, der in einem Gerätebrowser gerendert wird. Steuerelementeigenschaften sollten vor dieser Phase des Lebenszyklus und nur die tatsächliche Markuperstellung für das Hier ausgeführte Steuerelement festgelegt werden. Änderungen, die an dem Steuerelement in dieser Phase des Lebenszyklus vorgenommen wurden, werden nicht im Ansichtszustand gespeichert. Zum Speichern von Änderungen, die am Steuerelement vorgenommen wurden, überschreiben Sie das OnPreRender Ereignis.
Das Render Ereignis ermöglicht es abgeleiteten Klassen auch, das Ereignis zu behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik zum Behandeln des Ereignisses in einer abgeleiteten Klasse.
