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 ze strumieniem wyjściowym 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
Zawierające HtmlTextWriter metody 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 dla klasy HideDisabledControlAdapter.
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ę ze strumieniem wyjściowym jako HTML.
Domyślnie program .NET Framework wywołuje własną Render metodę kontrolki serwera sieci Web. Jednak po ustawieniu Adapter właściwości tej kontrolki program .NET Framework będzie wykonywać implementację Render karty zdarzenia 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 znaczników dla kontrolki wykonanej tutaj. Zmiany wprowadzone w kontrolce na tym etapie cyklu życia nie są zapisywane w celu wyświetlenia stanu. Aby zapisać zmiany wprowadzone w kontrolce, przesłoń OnPreRender zdarzenie.
Zdarzenie Render umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata, co jest preferowaną techniką obsługi zdarzenia w klasie pochodnej.