Control.RenderControl Метод

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)

Параметры

Примеры

В следующем примере метод переопределяется 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

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)

Параметры

Комментарии

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

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

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

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

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

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

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