Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Method

Определение

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

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

Объект HtmlTextWriter, получающий преображенное содержимое.The HtmlTextWriter object that receives the rendered content.

Примеры

В следующем примере переопределяется RenderChildren метод в пользовательском серверном элементе управления.The following example overrides the RenderChildren method in a custom server control. Он определяет, имеет ли текущий элемент управления дочерние элементы ControlCollection управления в своем объекте.It determines whether the current control has any child controls in its ControlCollection object. Если это так, он использует Count свойство для прохода по коллекции.If it does, it uses the Count property to iterate through the collection. При обнаружении каждого дочернего элемента управления он использует RenderControl метод для отрисовки родительского элемента управления и всех его дочерних элементов управления на странице, на которой он находится.As it encounters each child control, it uses the RenderControl method to render the parent control, and all of its child controls, to the containing page.

Затем переопределенный Render метод вызывает переопределенный RenderChildren метод.The overridden Render method then calls the overridden RenderChildren method.

// 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 страниц (ASP) на странице.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Если на странице не существует кода ASP, этот метод визуализирует все дочерние элементы управления для серверного элемента управления.If no ASP code exists on the page, this method renders any child controls for the server control. Этот метод вызывается Render методом.This method is called by the Render method.

Применяется к

Дополнительно