WebControl.AddAttributesToRender(HtmlTextWriter) Metoda

Definicja

Dodaje atrybuty HTML i style, które muszą być renderowane do określonego HtmlTextWriterTag .Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Ta metoda jest używana głównie przez deweloperów kontroli.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)

Parametry

writer
HtmlTextWriter

HtmlTextWriterReprezentuje strumień wyjściowy, aby renderować zawartość HTML na kliencie.A HtmlTextWriter that represents the output stream to render HTML content on the client.

Przykłady

Poniższy przykład pokazuje, jak utworzyć klasę, która dziedziczy z WebControl klasy.The following example demonstrates how to create a class that derives from the WebControl class. Podstawowa implementacja AddAttributesToRender metody została zastąpiona, aby dodać atrybuty odpowiednie do klasy pochodnej w HtmlTextWriter strumieniu wyjściowym.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

Uwagi

Aby renderować atrybuty i style dla kontrolki serwer sieci Web na kliencie, zazwyczaj wywoływana jest AddAttribute Metoda i, HtmlTextWriter.AddStyleAttribute Aby wstawić każdy atrybut i styl indywidualnie do HtmlTextWriter strumienia wyjściowego.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. Aby uprościć proces, ta metoda hermetyzuje wszystkie wywołania HtmlTextWriter.AddAttribute HtmlTextWriter.AddStyleAttribute metod i dla każdego atrybutu i stylu skojarzonego z kontrolką serwera sieci Web.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. Wszystkie atrybuty i style są wstawiane do HtmlTextWriter strumienia wyjściowego w pojedynczym wywołaniu metody.All attributes and styles are inserted into the HtmlTextWriter output stream in a single method call. Ta metoda jest zwykle zastępowana przez deweloperów formantów w klasach pochodnych do wstawiania odpowiednich atrybutów i stylów do HtmlTextWriter strumienia wyjściowego dla klasy.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.

Uwaga

AddAttributesToRenderNie można użyć metody do wstawienia skryptu klienta.The AddAttributesToRender method cannot be used to insert client script. Aby użyć skryptu klienta, zapoznaj się z ClientScriptManager klasą.To use client script, see the ClientScriptManager class.

Dotyczy

Zobacz też