HideDisabledControlAdapter.Render(HtmlTextWriter) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapisuje skojarzona kontrolka sieci Web do strumienia wyjściowego jako 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)
Parametry
- writer
- HtmlTextWriter
Metody HtmlTextWriter zawierające do kompilowania i renderowania danych wyjściowych specyficznych dla urządzenia.
Przykłady
W poniższym przykładzie kodu pokazano, jak przesłonić HtmlTextWriter metodę Render przekazywania obiektu do kontrolki nadrzędnej do renderowania, jeśli skojarzona kontrolka jest włączona. Ten przykład kodu jest częścią większego przykładu udostępnionego HideDisabledControlAdapter dla klasy .
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
Uwagi
Metoda Render zapisuje skojarzona WebControl kontrolkę do strumienia wyjściowego jako HTML.
Domyślnie .NET Framework wywołuje własną Render metodę kontrolki serwera sieci Web. Jednak po ustawieniu Adapter właściwości tej kontrolki .NET Framework wykona implementację Render zdarzenia adaptera dla skojarzonej kontrolki.
Zdarzenie Render służy do przeprowadzania modyfikacji kodu znaczników renderowanego w przeglądarce urządzenia. Właściwości kontrolki należy ustawić przed tą fazą cyklu życia i tylko rzeczywiste tworzenie narzutu dla kontrolki wykonanej tutaj. Zmiany wprowadzone w kontrolce na tym etapie cyklu życia nie są zapisywane w stanie widoku. Aby zapisać zmiany wprowadzone w kontrolce, zastąpij OnPreRender zdarzenie.
Zdarzenie Render umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata, który jest preferowaną techniką obsługi zdarzenia w klasie pochodnej.