Control.RenderControl Metod

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)

Parametrar

Exempel

I följande exempel åsidosätts RenderChildren metoden i en anpassad serverkontroll. Den avgör om den aktuella kontrollen har några underordnade kontroller i objektet ControlCollection . Om den gör det använder den Count egenskapen för att iterera genom samlingen. När den stöter på varje underordnad kontroll använder den RenderControl metoden för att återge den underordnade kontrollen, och alla dess underordnade kontroller, till den innehållande sidan. Objektet XhtmlTextWriter som skickas till den här metoden instansieras av Render metoden.

// 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

Kommentarer

Om en serverkontrolls Visible egenskap är inställd på trueavgör den här metoden om spårning är aktiverat för sidan. I så fall lagrar den spårningsinformation som är associerad med kontrollen och återger serverkontrollinnehållet till sidan.

Den här metoden anropas automatiskt av sidan under återgivningen, men kan åsidosättas av utvecklare av anpassad kontroll.

Se även

• HtmlTextWriter

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)

Parametrar

Kommentarer

ASP.NET webbsidor kan användas på en mängd olika enheter och webbläsare som kan begära information från webben. Egenskapen Adapter returnerar det ControlAdapter objekt som återger kontrollen på den begärande enheten eller webbläsarens skärm.

Mer information om kort finns i Arkitekturöversikt över beteende för anpassningsbar kontroll.

Om en serverkontrolls Visible egenskap är inställd på true och spårning är aktiverad för sidan registreras spårningsinformation som är associerad med kontrollen.

Anteckningar till arvingar

När du åsidosättar RenderControl(HtmlTextWriter, ControlAdapter) metoden i anpassade kontroller anropar du basklassmetoden för att säkerställa att spårningsinformationen registreras korrekt.

Se även

• Adapter
• ControlAdapter
• Trace
• Arkitekturöversikt över beteende för anpassningsbar kontroll