WebControl.AddAttributesToRender(HtmlTextWriter) WebControl.AddAttributesToRender(HtmlTextWriter) WebControl.AddAttributesToRender(HtmlTextWriter) WebControl.AddAttributesToRender(HtmlTextWriter) Method

Definition

Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.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)

Parameter

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Ein HtmlTextWriter, der den Ausgabestream zum Rendern des HTML-Inhalts auf dem Client darstellt.A HtmlTextWriter that represents the output stream to render HTML content on the client.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine Klasse erstellt wird, die WebControl von der-Klasse abgeleitet wird.The following example demonstrates how to create a class that derives from the WebControl class. Die Basis Implementierung der AddAttributesToRender -Methode wird überschrieben, um der abgeleiteten Klasse HtmlTextWriter im Ausgabestream geeignete Attribute hinzuzufügen.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

Hinweise

Um Attribute und Stile für ein Webserver Steuerelement auf dem Client zu rendern, werden in AddAttribute der HtmlTextWriter.AddStyleAttribute Regel die-Methode und die-Methode aufgerufen, HtmlTextWriter um die einzelnen Attribute und Stile einzeln in den Ausgabestream einzufügenTo 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. Um den Prozess zu vereinfachen, kapselt diese Methode alle Aufrufe der HtmlTextWriter.AddAttribute - HtmlTextWriter.AddStyleAttribute Methode und der-Methode für jedes Attribut und jeden Stil, die dem Webserver Steuerelement zugeordnet sind.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. Alle Attribute und Stile werden in einem einzelnen HtmlTextWriter Methoden aufrufin den Ausgabestream eingefügt.All attributes and styles are inserted into the HtmlTextWriter output stream in a single method call. Diese Methode wird in der Regel von Steuerelement Entwicklern in abgeleiteten Klassen überschrieben, um die entsprechenden Attribute HtmlTextWriter und Stile in den Ausgabestream für die-Klasse einzufügen.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.

Hinweis

Die AddAttributesToRender -Methode kann nicht zum Einfügen von Client Skripts verwendet werden.The AddAttributesToRender method cannot be used to insert client script. Informationen zur Verwendung von Client Skripts ClientScriptManager finden Sie in der-Klasse.To use client script, see the ClientScriptManager class.

Gilt für:

Siehe auch