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 eine Klasse erstellt wird, die von der WebControl -Klasse abgeleitet wird. Die Basisimplementierung der AddAttributesToRender -Methode wird überschrieben, um attribute hinzuzufügen, die der abgeleiteten Klasse im HtmlTextWriter Ausgabedatenstrom 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 Stilen für ein Webserversteuerelement auf dem Client rufen Sie in der Regel die AddAttribute Methoden und auf HtmlTextWriter.AddStyleAttribute , um jedes Attribut und jede Formatvorlage einzeln in den HtmlTextWriter Ausgabedatenstrom einzufügen. Um den Prozess zu vereinfachen, kapselt diese Methode alle Aufrufe der HtmlTextWriter.AddAttribute Methoden und HtmlTextWriter.AddStyleAttribute für jedes Attribut und jeden Stil, der dem Webserversteuerelement zugeordnet ist. Alle Attribute und Stile werden in einem einzelnen Methodenaufruf in den HtmlTextWriter Ausgabedatenstrom eingefügt. Diese Methode wird in der Regel von Steuerelemententwicklern in abgeleiteten Klassen überschrieben, um die entsprechenden Attribute und Stile in den HtmlTextWriter Ausgabestream für die 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:

Freigeben über