AttributeCollection.Add-Methode

Artikel
08/20/2007

Fügt dem AttributeCollection-Objekt eines Serversteuerelements ein Attribut hinzu.

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

Syntax

'Declaration
Public Sub Add ( _
    key As String, _
    value As String _
)
'Usage
Dim instance As AttributeCollection
Dim key As String
Dim value As String

instance.Add(key, value)

public void Add (
    string key,
    string value
)

public:
void Add (
    String^ key, 
    String^ value
)

public void Add (
    String key, 
    String value
)

public function Add (
    key : String, 
    value : String
)

Parameter

key
Der dem neuen Attribut in der Auflistung zugewiesene Index.

value
Das in der Auflistung zu speichernde Attribut.

Hinweise

Ein typischer Fall für die Verwendung dieser Methode ist, wenn Benutzer die häufig von ihnen besuchten Seiten personalisieren.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie mithilfe der Add-Methode der AttributeCollection eines ASP.NET-Serversteuerelements ein Attribut programmgesteuert hinzugefügt wird.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
    Protected Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        FirstSelect.Attributes.Add("Multiple", "True")
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>AttributeCollection Example</title>
</head>

 <body>
    <form id="form1" runat="server">
    <div>
    Make a selection:
    <select id="FirstSelect" 
            runat="server">
       <option>This</option>
       <option>That</option>
       <option>Other</option>
    </select>
    <br/><br/>

    <input type="submit" 
           id="SubmitBtn"
           value="Modify Attribute" 
           onserverclick="SubmitBtn_Click" 
           runat="server"/>
    </div>
 </form>
 </body>
 </html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
    protected void SubmitBtn_Click(object sender, EventArgs e)
    {
        FirstSelect.Attributes.Add("Multiple", "True");
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>AttributeCollection Example</title>
</head>

 <body>
    <form id="form1" runat="server">
    <div>
    Make a selection:
    <select id="FirstSelect" 
            runat="server">
       <option>This</option>
       <option>That</option>
       <option>Other</option>
    </select>
    <br/><br/>

    <input type="submit" 
           id="SubmitBtn"
           value="Modify Attribute" 
           onserverclick="SubmitBtn_Click" 
           runat="server"/>
    </div>
 </form>
 </body>
 </html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

 <script language="jscript" runat="server">
    function SubmitBtn_Click(Src, e : EventArgs){
        FirstSelect.Attributes.Add("Multiple", 
                "True");
    }
 </script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>AttributeCollection Example</title>
</head>

 <body>
    <form id="form1" runat="server">
    <div>
    Make a selection:
    <select id="FirstSelect" 
            runat="server">
       <option>This</option>
       <option>That</option>
       <option>Other</option>
    </select>
    <br/><br/>

    <input type="submit" 
           id="SubmitBtn"
           value="Modify Attribute" 
           onserverclick="SubmitBtn_Click"
           runat="server"/>
    </div>
 </form>
 </body>
 </html>

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
Attributes
Attributes

Freigeben über