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 -> unitProtected 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
Комментарии
Для отрисовки атрибутов и стилей для элемента управления web Server на клиенте обычно вызываются AddAttribute методы и HtmlTextWriter.AddStyleAttribute , чтобы вставить каждый атрибут и стиль по отдельности в выходной HtmlTextWriter поток. Чтобы упростить процесс, этот метод инкапсулирует все вызовы HtmlTextWriter.AddAttribute методов и HtmlTextWriter.AddStyleAttribute для каждого атрибута и стиля, связанного с серверным веб-элементом управления. Все атрибуты и стили вставляются в выходной HtmlTextWriter поток в одном вызове метода. Этот метод обычно переопределяется разработчиками элементов управления в производных классах для вставки соответствующих атрибутов и стилей в HtmlTextWriter поток вывода для класса .
Примечание
Метод AddAttributesToRender нельзя использовать для вставки клиентского скрипта. Чтобы использовать клиентский ClientScriptManager скрипт, см. класс .
