WebControl.AddAttributesToRender(HtmlTextWriter) Methode
Definition
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.