Control.RenderControl Metoda

Definicja

Wyprowadza zawartość kontrolki serwera i przechowuje informacje o śledzeniu, jeśli śledzenie jest włączone.Outputs server control content and stores tracing information about the control if tracing is enabled.

Przeciążenia

RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego obiektu HtmlTextWriter i przechowuje informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego obiektu HtmlTextWriter przy użyciu podanego obiektu ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego obiektu HtmlTextWriter i przechowuje informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

public:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public void RenderControl (System.Web.UI.HtmlTextWriter writer);
public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);
member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
Public Sub RenderControl (writer As HtmlTextWriter)
Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Parametry

writer
HtmlTextWriter

Obiekt HtmlTextWriter, który odbiera zawartość kontrolki.The HtmlTextWriter object that receives the control content.

Przykłady

Poniższy przykład zastępuje metodę RenderChildren w niestandardowym formancie serwera.The following example overrides the RenderChildren method in a custom server control. Określa, czy bieżący formant zawiera wszystkie kontrolki podrzędne w obiekcie ControlCollection.It determines whether the current control has any child controls in its ControlCollection object. Jeśli tak, używa właściwości Count do iteracji w kolekcji.If it does, it uses the Count property to iterate through the collection. Gdy napotka każdy formant podrzędny, używa metody RenderControl, aby renderować formant podrzędny i wszystkie jego formanty podrzędne do strony zawierającej.As it encounters each child control, it uses the RenderControl method to render the child control, and all of its child controls, to the containing page. Obiekt XhtmlTextWriter, który jest przesyłany do tej metody jest skonkretyzowany przez metodę Render.The XhtmlTextWriter object that is passed to this method is instantiated by the Render method.

// 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 formantu serwera ma wartość true, ta metoda określa, czy śledzenie jest włączone dla strony.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. Jeśli tak, przechowuje informacje o śledzeniu skojarzone z kontrolką i renderuje zawartość kontrolki serwer na stronie.If so, it stores trace information associated with the control, and renders the server control content to the page.

Ta metoda jest automatycznie wywoływana przez stronę podczas renderowania, ale może zostać przesłonięta przez deweloperów kontrolek niestandardowych.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

Zobacz też

RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego obiektu HtmlTextWriter przy użyciu podanego obiektu ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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, który odbiera zawartość kontrolki.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter

ControlAdapter, który definiuje renderowanie.The ControlAdapter that defines the rendering.

Uwagi

ASP.NET strony sieci Web są użyteczne na wielu urządzeniach i w przeglądarkach, które mogą żądać informacji z sieci Web.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. Właściwość Adapter zwraca obiekt ControlAdapter, który renderuje formant na ekranie żądającym urządzenia lub przeglądarki.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Aby uzyskać więcej informacji na temat kart sieciowych, zobacz Omówienie architektury działania kontroli adaptacyjnej.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Jeśli właściwość Visible formantu serwera jest ustawiona na true i śledzenie jest włączone dla strony, śledzenie informacji skojarzonych z kontrolką jest przechwytywane.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Uwagi dotyczące dziedziczenia

Podczas zastępowania metody RenderControl(HtmlTextWriter, ControlAdapter) w kontrolkach niestandardowych Wywołaj metodę klasy bazowej, aby upewnić się, że informacje o śledzeniu są prawidłowo przechwytywane.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

Zobacz też

Dotyczy