Control.RenderChildren(HtmlTextWriter) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi.

protected public:
 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 Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

Parametry

writer

HtmlTextWriter

Objekt HtmlTextWriter , který obdrží vykreslený obsah.

Příklady

Následující příklad přepíše metodu RenderChildren ve vlastním ovládacím prvku serveru. Určuje, zda aktuální ovládací prvek má v objektu ControlCollection jakékoli podřízené ovládací prvky. Pokud ano, použije Count vlastnost k iteraci v kolekci. Jak narazí na každý podřízený ovládací prvek, používá metodu RenderControl k vykreslení nadřazeného ovládacího prvku a všech jeho podřízených ovládacích prvků na stránku obsahující.

Přepsaná Render metoda pak volá přepsánou RenderChildren metodu.

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

Poznámky

Tato metoda upozorní ASP.NET, že na stránce vykreslí jakýkoli kód asp (Active Server Pages). Pokud na stránce neexistuje žádný kód ASP, tato metoda vykreslí všechny podřízené ovládací prvky pro serverový ovládací prvek. Tato metoda je volána metodou Render .

Viz také

• Render(HtmlTextWriter)
• RenderControl(HtmlTextWriter)