WebControl.AddAttributesToRender-Methode

Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Formatvorlagen hinzu. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overridable Sub AddAttributesToRender ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.AddAttributesToRender(writer)

protected virtual void AddAttributesToRender (
    HtmlTextWriter writer
)

protected:
virtual void AddAttributesToRender (
    HtmlTextWriter^ writer
)

protected void AddAttributesToRender (
    HtmlTextWriter writer
)

protected function AddAttributesToRender (
    writer : HtmlTextWriter
)

Parameter

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

Hinweise

Wenn Attribute und Formatvorlagen für ein Webserversteuerelement auf dem Client dargestellt werden sollen, rufen Sie normalerweise die AddAttribute-Methode und die System.Web.UI.HtmlTextWriter.AddStyleAttribute-Methode auf, um alle Attribute und Formatvorlagen einzeln in den HtmlTextWriter-Ausgabestream einzufügen. Diese Methode vereinfacht den Vorgang, indem sie alle Aufrufe der System.Web.UI.HtmlTextWriter.AddAttribute-Methode und der System.Web.UI.HtmlTextWriter.AddStyleAttribute-Methode für alle Attribute und Formatvorlagen kapselt, die dem Webserversteuerelement zugeordnet sind. Alle Attribute und Formatvorlagen werden durch einen einzigen Methodenaufruf in den HtmlTextWriter-Ausgabestream eingefügt. In abgeleiteten Klassen wird diese Methode von den Steuerelemententwicklern normalerweise überschrieben, um die geeigneten Attribute und Formatvorlagen in den HtmlTextWriter-Ausgabestream für die Klasse einzufügen.

Hinweis

Die AddAttributesToRender-Methode kann nicht zum Einfügen von Clientskripts verwendet werden. Informationen über das Verwenden von Clientskripts finden Sie unter der ClientScriptManager-Klasse.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie eine von der WebControl-Klasse abgeleitete Klasse erstellt wird. Die Basisimplementierung der AddAttributesToRender-Methode wird überschrieben, um die passenden Attribute für die abgeleitete Klasse im HtmlTextWriter-Ausgabestream hinzuzufügen.

Imports System
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 'New      
      
      <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 'AddAttributesToRender       

      <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 'RenderContents

   End Class 'MyWebControl

End Namespace 'ControlTest

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);
      }
   }
}

package ControlTest; 
import System.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;

// Renders the following HTML: 
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl extends WebControl
{
    public MyWebControl()
    {
         super(HtmlTextWriterTag.Span);
    } //MyWebControl

    protected void AddAttributesToRender(HtmlTextWriter writer)
    {
        writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
        writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
        super.AddAttributesToRender(writer);
    } //AddAttributesToRender

    /** @attribute System.Security.Permissions.PermissionSet(System.Security.
        Permissions.SecurityAction.Demand, Name = "FullTrust")
     */
    protected void RenderContents(HtmlTextWriter writer)
    {
        writer.Write("Custom Contents");
        super.RenderContents(writer);
    } //RenderContents
} //MyWebControl

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace
System.Web.UI.HtmlTextWriter.AddAttribute
System.Web.UI.HtmlTextWriter.AddStyleAttribute
HtmlTextWriter

Weitere Ressourcen

Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen