Control.Render(HtmlTextWriter) Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

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

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

protected 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 Overridable Sub Render (writer As HtmlTextWriter)

Protected Friend Overridable Sub Render (writer As HtmlTextWriter)

Параметры

writer

HtmlTextWriter

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

Примеры

В следующем примере кода показано переопределение Render метода. Этот HasControls метод используется для определения того, имеет ли серверный элемент управления какие-либо дочерние элементы управления, хранящиеся в его ControlCollection объекте, который доступен через Control.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