WebControl.AddAttributesToRender(HtmlTextWriter) Metodo

Definizione

Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

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)

Parametri

writer
HtmlTextWriter

Oggetto HtmlTextWriter che rappresenta il flusso di output di cui eseguire il rendering del contenuto HTML nel client.

Esempio

Nell'esempio WebControl seguente viene illustrato come creare una classe che deriva dalla classe . L'implementazione di base del AddAttributesToRender metodo viene sottoposto a override per aggiungere attributi appropriati alla classe derivata nel HtmlTextWriter flusso di output.

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

Commenti

Per eseguire il rendering di attributi e stili per un controllo Server Web nel client, in genere si chiamano i AddAttribute metodi e HtmlTextWriter.AddStyleAttribute per inserire ogni attributo e stile singolarmente al HtmlTextWriter flusso di output. Per semplificare il processo, questo metodo incapsula tutte le chiamate ai HtmlTextWriter.AddAttribute metodi e per ogni attributo e HtmlTextWriter.AddStyleAttribute stile associato al controllo server Web. Tutti gli attributi e gli stili vengono inseriti nel HtmlTextWriter flusso di output in una singola chiamata al metodo. Questo metodo viene in genere sottoposto a override dagli sviluppatori di controlli nelle classi derivate per inserire gli attributi e gli stili appropriati al HtmlTextWriter flusso di output per la classe.

Nota

Impossibile usare il AddAttributesToRender metodo per inserire lo script client. Per usare lo script client, vedere la ClientScriptManager classe .

Si applica a

Vedi anche