AttributeCollection.AddAttributes-Methode

Artikel
08/20/2007

Fügt dem HtmlTextWriter-Objekt, das für die Darstellung der Attribute als HTML bei einem ASP.NET-Serversteuerelement zuständig ist, Attribute aus der AttributeCollection-Klasse hinzu.

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

Syntax

'Declaration
Public Sub AddAttributes ( _
    writer As HtmlTextWriter _
)
'Usage
Dim instance As AttributeCollection
Dim writer As HtmlTextWriter

instance.AddAttributes(writer)

public void AddAttributes (
    HtmlTextWriter writer
)

public:
void AddAttributes (
    HtmlTextWriter^ writer
)

public void AddAttributes (
    HtmlTextWriter writer
)

public function AddAttributes (
    writer : HtmlTextWriter
)

Parameter

writer
Ein HtmlTextWriter, der das hinzugefügte Attribut in das öffnende Tag eines ASP.NET-Serversteuerelements schreibt.

Hinweise

Diese Methode kopiert alle Attribute des Serversteuerelements in ein HtmlTextWriter-Objekt, sodass die Attribute beim nächsten Aufruf der RenderBeginTag-Methode dargestellt werden können.

Sie können die Leistung von Serversteuerelementen, die durch Surrogatsteuerelemente dargestellt werden, potenziell dadurch verbessern, dass Sie sie direkt darstellen. Dies gilt z. B. für ein Calendar-Steuerelement oder ein CheckBoxList-Steuerelement. Die direkte Darstellung ist schneller als die Darstellung durch Surrogatsteuerelemente, da es bei Surrogatsteuerelementen erforderlich ist, alle Attribute von untergeordneten Steuerelementen in das jeweilige Surrogatsteuerelement zu kopieren und die Attribute danach darzustellen.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie einem Button-Serversteuerelement, myButton, und einem TextBox-Serversteuerelement, myTextBox, neue Attribute hinzugefügt werden, und wie diese Attribute anschließend einem benutzerdefinierten HtmlTextWriter hinzugefügt werden, der sie in einen Ausgabestream für jedes dieser Steuerelemente schreibt.

myButton.Attributes.Clear()
myTextBox.Attributes.Clear()
myButton.Attributes("onClick") = "javascript:alert('Visiting msn.com');"

myTextBox.Attributes("name") = "MyTextBox"

myTextBox.Attributes("onBlur") = "javascript:alert('Leaving MyTextBox...');"

Dim myHttpResponse As HttpResponse = Response
Dim myHtmlTextWriter As New HtmlTextWriter(myHttpResponse.Output)

myButton.Attributes.AddAttributes(myHtmlTextWriter)
myTextBox.Attributes.AddAttributes(myHtmlTextWriter)

myButton.Attributes.Clear();
myTextBox.Attributes.Clear();
myButton.Attributes["onClick"] = 
                "javascript:alert('Visiting msn.com');";

myTextBox.Attributes["name"] = "MyTextBox";

myTextBox.Attributes["onBlur"] = 
                 "javascript:alert('Leaving MyTextBox...');";
                           
HttpResponse myHttpResponse = Response;
HtmlTextWriter myHtmlTextWriter  = 
                 new HtmlTextWriter(myHttpResponse.Output);

myButton.Attributes.AddAttributes(myHtmlTextWriter);
myTextBox.Attributes.AddAttributes(myHtmlTextWriter);

myButton.get_Attributes().Clear();
myTextBox.get_Attributes().Clear();
myButton.get_Attributes().set_Item("onClick", 
    "javascript:alert('Visiting msn.com');");

myTextBox.get_Attributes().set_Item("name","MyTextBox");

myTextBox.get_Attributes().set_Item("onBlur",
    "javascript:alert('Leaving MyTextBox...');");

HttpResponse myHttpResponse = get_Response();
HtmlTextWriter myHtmlTextWriter  = new HtmlTextWriter(myHttpResponse.
    get_Output());

myButton.get_Attributes().AddAttributes(myHtmlTextWriter);
myTextBox.get_Attributes().AddAttributes(myHtmlTextWriter);

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

AttributeCollection-Klasse
AttributeCollection-Member
System.Web.UI-Namespace
RenderBeginTag

Freigeben über