Control.RenderControl Control.RenderControl Control.RenderControl Control.RenderControl Method

Определение

Выводит содержимое серверного элемента управления и сохраняет сведения трассировки элемента управления, если трассировка включена.Outputs server control content and stores tracing information about the control if tracing is enabled.

Перегрузки

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);
abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Параметры

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Объект HtmlTextWriter, получающий содержимое элемента управления.The HtmlTextWriter object that receives the control 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 child control, and all of its child controls, to the containing page. Объект, передаваемый в этот метод, создается Render методом. XhtmlTextWriterThe XhtmlTextWriter object that is passed to this method is instantiated by the Render 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 'RenderChildren
      
      
      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

Комментарии

Если Visible свойство серверного элемента управления имеет trueзначение, этот метод определяет, включена ли трассировка для страницы.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. Если да, то он хранит сведения о трассировке, связанные с элементом управления, и подготавливает к просмотру содержимое серверного элемента управления на странице.If so, it stores trace information associated with the control, and renders the server control content to the page.

Этот метод автоматически вызывается страницей во время отрисовки, но может быть переопределен разработчиками пользовательских элементов управления.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

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

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

protected:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);
protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);
member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit
Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)

Параметры

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

HtmlTextWriter, получающий содержимое элемента управления.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter ControlAdapter ControlAdapter ControlAdapter

ControlAdapter, определяющий отрисовку.The ControlAdapter that defines the rendering.

Комментарии

Веб-страницы ASP.NET можно использовать для широкого спектра устройств и браузеров, которые могут запрашивать информацию из Интернета.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. Adapter СвойствоControlAdapter возвращает объект, который визуализирует элемент управления на экране запрашивающего устройства или браузера.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Дополнительные сведения о адаптерах см. в разделе Обзор архитектуры адаптивного управления поведением.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Если Visible свойство серверного элемента управления имеет true значение, а для страницы включена трассировка, то захватывается информация трассировки, связанная с этим элементом управления.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Примечания для тех, кто наследует этот метод

При переопределении RenderControl(HtmlTextWriter, ControlAdapter) метода в пользовательских элементах управления вызовите метод базового класса, чтобы убедиться, что информация трассировки правильно захвачена.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

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

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