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

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

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

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

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

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

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