Control.RenderChildren(HtmlTextWriter) Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.dll

Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten.

protected:
 virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
 virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void RenderChildren(System.Web.UI.HtmlTextWriter writer);
protected internal virtual void RenderChildren(System.Web.UI.HtmlTextWriter writer);
abstract member RenderChildren : System.Web.UI.HtmlTextWriter -> unit
override this.RenderChildren : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub RenderChildren (writer As HtmlTextWriter)
Protected Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

Parametrar

writer
HtmlTextWriter

Objektet HtmlTextWriter som tar emot det renderade innehållet.

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 överordnade kontrollen, och alla dess underordnade kontroller, till den innehållande sidan.

Den åsidosatta Render metoden anropar sedan den åsidosatta RenderChildren 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

Den här metoden meddelar ASP.NET att återge asp-kod (Active Server Pages) på sidan. Om det inte finns någon ASP-kod på sidan återger den här metoden eventuella underordnade kontroller för serverkontrollen. Den här metoden anropas av Render metoden.

Gäller för

Se även