WebControl.AddAttributesToRender(HtmlTextWriter) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

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)

Parameter

writer: HtmlTextWriter

Ein HtmlTextWriter, der den Ausgabestream zum Rendern des HTML-Inhalts auf dem Client darstellt.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie eine Klasse erstellen, die von der WebControl Klasse abgeleitet wird. Die Basisimplementierung der AddAttributesToRender Methode wird außer Kraft gesetzt, um attribute hinzuzufügen, die der abgeleiteten Klasse im HtmlTextWriter Ausgabestrom entsprechen.

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

Hinweise

Zum Rendern von Attributen und Formatvorlagen für ein Web Server-Steuerelement auf dem Client rufen Sie in der Regel die AddAttribute HtmlTextWriter.AddStyleAttribute methoden auf, um jedes Attribut und jede Formatvorlage einzeln in den HtmlTextWriter Ausgabedatenstrom einzufügen. Um den Prozess zu vereinfachen, kapselt diese Methode alle Aufrufe und Methoden für jedes Attribut und jede Formatvorlage, die HtmlTextWriter.AddAttribute HtmlTextWriter.AddStyleAttribute dem Webserversteuerelement zugeordnet ist. Alle Attribute und Formatvorlagen werden in den HtmlTextWriter Ausgabedatenstrom in einem einzigen Methodenaufruf eingefügt. Diese Methode wird in der Regel von Steuerelemententwicklern in abgeleiteten Klassen außer Kraft gesetzt, um die entsprechenden Attribute und Formatvorlagen in den Ausgabedatenstrom für die HtmlTextWriter Klasse einzufügen.

Hinweis

Die AddAttributesToRender Methode kann nicht zum Einfügen von Clientskripts verwendet werden. Informationen zum Verwenden des Clientskripts finden Sie in der ClientScriptManager Klasse.

Gilt für