Freigeben über


SecurityElement.AddAttribute-Methode

Fügt einem XML-Element ein Name-/Wert-Attribut hinzu.

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub AddAttribute ( _
    name As String, _
    value As String _
)
'Usage
Dim instance As SecurityElement
Dim name As String
Dim value As String

instance.AddAttribute(name, value)
public void AddAttribute (
    string name,
    string value
)
public:
void AddAttribute (
    String^ name, 
    String^ value
)
public void AddAttribute (
    String name, 
    String value
)
public function AddAttribute (
    name : String, 
    value : String
)

Parameter

  • name
    Der Name des Attributs.
  • value
    Der Wert des Attributs.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

Der name-Parameter oder der value-Parameter ist NULL (Nothing in Visual Basic).

ArgumentException

Der name-Parameter oder der value-Parameter ist in XML ungültig.

– oder –

Ein Attribut mit dem vom name-Parameter angegebenen Namen ist bereits vorhanden.

Hinweise

Namen und Werte in Attributen dürfen nur gültige XML-Attributzeichen enthalten. XML-Attributnamen müssen eindeutig sein. Verwenden Sie Escape, um ungültige Zeichen aus der Zeichenfolge zu entfernen.

Zeichenfolgen in Anführungszeichen werden nicht unterstützt. Deshalb dürfen Zeichenfolgen für Name-/Wertpaare weder Anführungszeichen noch sonstige Zeichen enthalten, die Anführungszeichen erfordern.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der AddAttribute-Methode zum Hinzufügen eines Namens-/Wertattributs zu einem XML-Element veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die SecurityElement-Klasse.

windowsRoleElement.AddAttribute("version", "1.00")
windowsRoleElement.AddAttribute("version","1.00");
windowsRoleElement->AddAttribute( L"version", L"1.00" );
windowsRoleElement.AddAttribute("version", "1.00");

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

SecurityElement-Klasse
SecurityElement-Member
System.Security-Namespace