WebControl.AddAttributesToRender(HtmlTextWriter) Метод

Определение

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

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-содержимое для просмотра на клиентском компьютере.A HtmlTextWriter that represents the output stream to render HTML content on the client.

Примеры

В следующем примере показано, как создать класс, производный от WebControl класса.The following example demonstrates how to create a class that derives from the WebControl class. Базовая реализация AddAttributesToRender метода переопределяется для добавления атрибутов, соответствующих производному классу HtmlTextWriter в выходном потоке.The base implementation of the AddAttributesToRender method is overridden to add attributes appropriate to the derived class in the HtmlTextWriter output stream.

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 и стиля по отдельности в поток вывода.To render attributes and styles for a Web Server control on the client, you typically call the AddAttribute and HtmlTextWriter.AddStyleAttribute methods to insert each attribute and style individually to the HtmlTextWriter output stream. Чтобы упростить процесс, этот метод инкапсулирует все вызовы HtmlTextWriter.AddAttribute методов и HtmlTextWriter.AddStyleAttribute для каждого атрибута и стиля, связанного с серверным веб-элементом управления.To simplify the process, this method encapsulates all calls to the HtmlTextWriter.AddAttribute and HtmlTextWriter.AddStyleAttribute methods for every attribute and style associated with the Web server control. Все атрибуты и стили вставляются в HtmlTextWriter поток вывода в одном вызове метода.All attributes and styles are inserted into the HtmlTextWriter output stream in a single method call. Этот метод обычно переопределяется разработчиками элементов управления в производных классах для вставки соответствующих атрибутов и стилей HtmlTextWriter в выходной поток для класса.This method is typically overridden by control developers in derived classes to insert the appropriate attributes and styles to the HtmlTextWriter output stream for the class.

Примечание

AddAttributesToRender Метод не может использоваться для вставки клиентского скрипта.The AddAttributesToRender method cannot be used to insert client script. Чтобы использовать клиентский скрипт, см ClientScriptManager . класс.To use client script, see the ClientScriptManager class.

Применяется к

Дополнительно