Control.Render(HtmlTextWriter) Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

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

protected internal virtual void Render (System.Web.UI.HtmlTextWriter writer);

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

Protected Friend Overridable Sub Render (writer As HtmlTextWriter)

Параметры

writer

HtmlTextWriter

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

Примеры

В следующем примере кода показано переопределение Render метода . Метод HasControls используется для определения наличия у серверного элемента управления дочерних элементов управления, хранящихся в объекте ControlCollectionControl.Controls , доступ к которому осуществляется через свойство . Если HasControls возвращает значение true и первым серверным элементом управления в коллекции является литеральный текст, то литеральный текст добавляется к строке HTML.

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render(HtmlTextWriter output) {
    if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
        output.Write("<H2>Your Message: " + ((LiteralControl) Controls[0]).Text + "</H2>");
    }
}

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
    If HasControls() And TypeOf Controls(0) Is LiteralControl
        Dim Ctrl As LiteralControl = CType(Controls(0), LiteralControl)
        Output.Write("<H2>Your Message: " & Ctrl.Text & "</H2>")
    End If
End Sub

Комментарии

При разработке пользовательских серверных элементов управления этот метод можно переопределить для создания содержимого для ASP.NET страницы.

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

• HtmlTextWriter
• Общие сведения о жизненном цикле страницы ASP.NET