Control.RenderControl Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

Перегрузки

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

RenderControl(HtmlTextWriter)

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

public:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public void RenderControl (System.Web.UI.HtmlTextWriter writer);

public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);

member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

Public Sub RenderControl (writer As HtmlTextWriter)

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 объект, который отображает элемент управления на экране запрашивающего устройства или браузера.

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

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

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

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

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

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