Control.RenderControl Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

W danych wyjściowych serwer kontroluje zawartość i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.

Przeciążenia

RenderControl(HtmlTextWriter)	Dane wyjściowe serwera kontrolują zawartość w podanym obiekcie HtmlTextWriter i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe serwera kontrolują zawartość dostarczonego obiektu HtmlTextWriter przy użyciu dostarczonego obiektu ControlAdapter.

RenderControl(HtmlTextWriter)

Dane wyjściowe serwera kontrolują zawartość w podanym obiekcie HtmlTextWriter i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);

abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Parametry

writer

HtmlTextWriter

Obiekt HtmlTextWriter, który odbiera zawartość kontrolki.

Przykłady

Poniższy przykład zastępuje metodę RenderChildren w niestandardowej kontroli serwera. Określa, czy bieżąca kontrolka ma jakiekolwiek kontrolki podrzędne w obiekcie ControlCollection. Jeśli tak, używa właściwości Count do iterowania po kolekcji. W miarę napotkania każdej kontrolki podrzędnej używa metody RenderControl do renderowania kontrolki podrzędnej i wszystkich kontrolek podrzędnych do strony zawierającej. Obiekt XhtmlTextWriter przekazywany do tej metody jest tworzone przez metodę Render.

// Override default implementation to Render children according to needs. 
protected override void RenderChildren(HtmlTextWriter output)
{
   if (HasControls())
   {
      // Render Children in reverse order.
      for(int i = Controls.Count - 1; i >= 0; --i)
      {
         Controls[i].RenderControl(output);
      }
   }         
}

protected override void Render(HtmlTextWriter output)
{       
   output.Write("<br>Message from Control : " + Message);       
   output.Write("Showing Custom controls created in reverse" +
                                                    "order");         
   // Render Controls.
   RenderChildren(output);
}

' Override default implementation to Render children according to needs. 
      Protected Overrides Sub RenderChildren(output As HtmlTextWriter)
         If HasControls() Then
            ' Render Children in reverse order.
            Dim i As Integer

            For i = Controls.Count - 1 To 0 Step -1
               Controls(i).RenderControl(output)
            Next

         End If
      End Sub
      
      
      Protected Overrides Sub Render(output As HtmlTextWriter)
         output.Write(("<br>Message from Control : " + Message))
         output.Write(("Showing Custom controls created in reverse" + "order"))
         ' Render Controls.
         RenderChildren(output)
      End Sub
   End Class

Uwagi

Jeśli właściwość Visible kontrolki serwera jest ustawiona na true, ta metoda określa, czy śledzenie jest włączone dla strony. Jeśli tak, przechowuje informacje śledzenia skojarzone z kontrolką i renderuje zawartość kontrolki serwera na stronie.

Ta metoda jest wywoływana automatycznie przez stronę podczas renderowania, ale może zostać zastąpiona przez deweloperów kontrolek niestandardowych.

Zobacz też

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Dane wyjściowe serwera kontrolują zawartość dostarczonego obiektu HtmlTextWriter przy użyciu dostarczonego obiektu ControlAdapter.

protected:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);

protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);

member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit

Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)

Parametry

writer

HtmlTextWriter

HtmlTextWriter odbierający zawartość kontrolki.

adapter

ControlAdapter

ControlAdapter definiujący renderowanie.

Uwagi

ASP.NET stron sieci Web można używać w wielu różnych urządzeniach i przeglądarkach, które mogą żądać informacji z sieci Web. Właściwość Adapter zwraca obiekt ControlAdapter, który renderuje kontrolkę na żądanym urządzeniu lub ekranie przeglądarki.

Aby uzyskać więcej informacji na temat kart, zobacz Omówienie architektury zachowania adaptacyjnej kontroli.

Jeśli właściwość Visible kontrolki serwera jest ustawiona na true i śledzenie jest włączone dla strony, przechwytywane są informacje śledzenia skojarzone z kontrolką.

Uwagi dotyczące dziedziczenia

Podczas zastępowania metody RenderControl(HtmlTextWriter, ControlAdapter) w kontrolkach niestandardowych wywołaj metodę klasy bazowej, aby upewnić się, że informacje śledzenia są poprawnie przechwytywane.

Zobacz też

• Adapter
• ControlAdapter
• Trace
• omówienie architektury zachowania adaptacyjnego sterowania