WebControl.AddAttributesToRender(HtmlTextWriter) Methode

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee worden HTML-kenmerken en -stijlen toegevoegd die moeten worden weergegeven aan de opgegeven HtmlTextWriterTag. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars.

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)

Parameters

writer
HtmlTextWriter

Een HtmlTextWriter stroom die de uitvoerstroom vertegenwoordigt om HTML-inhoud op de client weer te geven.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een klasse maakt die is afgeleid van de WebControl klasse. De basisuitvoering van de AddAttributesToRender methode wordt overschreven om kenmerken toe te voegen die geschikt zijn voor de afgeleide klasse in de HtmlTextWriter uitvoerstroom.

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

Opmerkingen

Als u kenmerken en stijlen voor een webserver-besturingselement op de client wilt weergeven, roept u meestal de AddAttribute en HtmlTextWriter.AddStyleAttribute methoden aan om elk kenmerk en elke stijl afzonderlijk in de HtmlTextWriter uitvoerstroom in te voegen. Ter vereenvoudiging van het proces omvat deze methode alle aanroepen naar de HtmlTextWriter.AddAttribute en HtmlTextWriter.AddStyleAttribute methoden voor elk kenmerk en elke stijl die aan het webserverbesturingselement is gekoppeld. Alle kenmerken en stijlen worden in de HtmlTextWriter uitvoerstroom ingevoegd in één methode-aanroep. Deze methode wordt doorgaans overschreven door controleontwikkelaars in afgeleide klassen om de juiste kenmerken en stijlen in te voegen in de HtmlTextWriter uitvoerstroom voor de klasse.

Note

De AddAttributesToRender methode kan niet worden gebruikt om clientscripts in te voegen. Als u het clientscript wilt gebruiken, raadpleegt u de ClientScriptManager klasse.

Van toepassing op

Zie ook