Control.RenderControl Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

Перегрузки

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

RenderControl(HtmlTextWriter)

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

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, получающий содержимое элемента управления.

Примеры

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

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

Комментарии

Если свойство серверного Visible элемента управления имеет значение true, этот метод определяет, включена ли трассировка для страницы. Если да, он сохраняет сведения трассировки, связанные с элементом управления, и отображает содержимое серверного элемента управления на странице.

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

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

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

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

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, получающий содержимое элемента управления.

adapter

ControlAdapter

ControlAdapter, определяющий отрисовку.

Комментарии

ASP.NET веб-страницы можно использовать на различных устройствах и браузерах, которые могут запрашивать информацию из Интернета. Свойство Adapter возвращает ControlAdapter объект , который отображает элемент управления на экране запрашивающего устройства или браузера.

Дополнительные сведения об адаптерах см. в статье Архитектурный обзор поведения адаптивного элемента управления.

Если свойству серверного Visible элемента управления присвоено значение true и для страницы включена трассировка, то данные трассировки, связанные с элементом управления, записываются.

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

При переопределении RenderControl(HtmlTextWriter, ControlAdapter) метода в пользовательских элементах управления вызовите метод базового класса, чтобы обеспечить правильную запись данных трассировки.

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

• Adapter
• ControlAdapter
• Trace
• Обзор архитектуры поведения адаптивного элемента управления