Control.RenderControl Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

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

Przeciążenia

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

RenderControl(HtmlTextWriter)

Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu 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 kontrolce serwera. Określa, czy bieżąca kontrolka ma jakiekolwiek kontrolki podrzędne w swoim ControlCollection obiekcie. Jeśli tak, używa Count właściwości do iterowania po kolekcji. W miarę napotkania każdej kontrolki podrzędnej używa RenderControl metody do renderowania kontrolki podrzędnej i wszystkich jej kontrolek podrzędnych na stronie zawierającej. Obiekt XhtmlTextWriter , który jest 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ść kontrolki Visible serwera jest ustawiona na truewartość , 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 automatycznie wywoływana 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 steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu.

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

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

adapter

ControlAdapter

Element 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 Internetu. Właściwość Adapter zwraca ControlAdapter obiekt renderujący kontrolkę na ekranie żądania lub przeglądarki.

Aby uzyskać więcej informacji na temat adapterów, zobacz Omówienie architektury zachowania adaptacyjnego sterowania.

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

Uwagi dotyczące dziedziczenia

Podczas zastępowania RenderControl(HtmlTextWriter, ControlAdapter) metody 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