WebControl.AddAttributesToRender(HtmlTextWriter) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления.
protected:
virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void AddAttributesToRender (System.Web.UI.HtmlTextWriter writer);
abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub AddAttributesToRender (writer As HtmlTextWriter)
Параметры
- writer
- HtmlTextWriter
Объект HtmlTextWriter, представляющий поток вывода для отрисовки HTML-содержимого на стороне клиента.
Примеры
В следующем примере показано, как создать класс, производный WebControl от класса. Базовая реализация AddAttributesToRender метода переопределяется для добавления атрибутов, соответствующих производному классу в выходном потоке HtmlTextWriter .
namespace ControlTest
{
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
// Renders the following HTML:
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl: WebControl {
public MyWebControl() : base(HtmlTextWriterTag.Span)
{ }
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void AddAttributesToRender(HtmlTextWriter writer)
{
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
base.AddAttributesToRender(writer);
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void RenderContents(HtmlTextWriter writer)
{
writer.Write("Custom Contents");
base.RenderContents(writer);
}
}
}
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace ControlTest
' Renders the following HTML:
' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
Public Class MyWebControl
Inherits WebControl
Public Sub New()
MyBase.New(HtmlTextWriterTag.Span)
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
MyBase.AddAttributesToRender(writer)
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
writer.Write("Custom Contents")
MyBase.RenderContents(writer)
End Sub
End Class
End Namespace 'ControlTest
Комментарии
Чтобы отобразить атрибуты и стили для элемента управления веб-сервера на клиенте, обычно вызывается AddAttribute метод и HtmlTextWriter.AddStyleAttribute методы для вставки каждого атрибута и стиля по отдельности в выходной HtmlTextWriter поток. Чтобы упростить процесс, этот метод инкапсулирует все вызовы HtmlTextWriter.AddAttribute и HtmlTextWriter.AddStyleAttribute методы для каждого атрибута и стиля, связанного с веб-серверным элементом управления. Все атрибуты и стили вставляются в выходной HtmlTextWriter поток в одном вызове метода. Этот метод обычно переопределяется разработчиками элементов управления в производных классах для вставки соответствующих атрибутов и стилей в выходной HtmlTextWriter поток класса.
Примечание
Метод AddAttributesToRender нельзя использовать для вставки клиентского скрипта. Сведения об использовании клиентского скрипта см. в ClientScriptManager классе.