Control.RenderChildren(HtmlTextWriter) Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

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)

Параметры

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)