Control.RenderChildren(HtmlTextWriter) Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте.

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)

Параметры

writer

HtmlTextWriter

Объект HtmlTextWriter , получающий отрисованное содержимое.

Примеры

В следующем примере метод переопределяется RenderChildren в пользовательском серверном элементе управления. Определяет, имеет ли текущий элемент управления дочерние элементы управления в объекте ControlCollection . Если это так, свойство используется Count для итерации через коллекцию. При обнаружении каждого дочернего элемента управления метод используется RenderControl для отрисовки родительского элемента управления и всех его дочерних элементов управления на содержащую страницу.

Затем переопределенный Render метод вызывает переопределенный RenderChildren метод.

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

Комментарии

Этот метод уведомляет ASP.NET отображать любой код active Server Pages (ASP) на странице. Если на странице нет кода ASP, этот метод отрисовывает дочерние элементы управления для серверного элемента управления. Этот метод вызывается методом Render .

См. также раздел

• Render(HtmlTextWriter)
• RenderControl(HtmlTextWriter)