XElement.SetAttributeValue(XName, Object) Methode

Definition

Legt den Wert eines Attributs fest, fügt ein Attribut hinzu oder entfernt ein Attribut.

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::Object ^ value);
public void SetAttributeValue (System.Xml.Linq.XName name, object value);
public void SetAttributeValue (System.Xml.Linq.XName name, object? value);
member this.SetAttributeValue : System.Xml.Linq.XName * obj -> unit
Public Sub SetAttributeValue (name As XName, value As Object)

Parameter

name
XName

Ein XName, der den Namen des zu ändernden Attributs enthält.

value
Object

Der Wert, der dem Attribut zugewiesen werden soll. Das Attribut wird entfernt, wenn der Wert null ist. Andernfalls wird der Wert in seine Zeichenfolgenentsprechung konvertiert und der Value-Eigenschaft des Attributs zugewiesen.

Ausnahmen

Der value ist eine Instanz von XObject

Beispiele

Im folgenden Beispiel wird ein -Element mit einem -Attribut erstellt. Anschließend wird diese Methode verwendet, um den Inhalt des Attributs zu ersetzen.

// Create an element with no content.
XElement root = new XElement("Root");

// Add some name/value pairs.
root.SetAttributeValue("Att1", 1);
root.SetAttributeValue("Att2", 2);
root.SetAttributeValue("Att3", 3);
Console.WriteLine(root);

// Modify one of the name/value pairs.
root.SetAttributeValue("Att2", 22);
Console.WriteLine(root);

// Remove one of the name/value pairs.
root.SetAttributeValue("Att3", null);
Console.WriteLine(root);
' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetAttributeValue("Att1", 1)
root.SetAttributeValue("Att2", 2)
root.SetAttributeValue("Att3", 3)
Console.WriteLine(root)

' Modify one of the name/value pairs.
root.SetAttributeValue("Att2", 22)
Console.WriteLine(root)

' Remove one of the name/value pairs.
root.SetAttributeValue("Att3", Nothing)
Console.WriteLine(root)

Dieses Beispiel erzeugt die folgende Ausgabe:

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

Hinweise

Diese Methode wurde entwickelt, um die Verwaltung einer Liste von Namen-Wert-Paaren als Gruppe von Attributen zu vereinfachen. Beim Verwalten der Liste müssen Sie Paare hinzufügen, Paare ändern oder Paare löschen. Wenn Sie diese Methode aufrufen und einen Namen übergeben, der nicht als Attribut vorhanden ist, erstellt diese Methode ein Attribut für Sie. Wenn Sie diese Methode aufrufen und den Namen eines vorhandenen Attributs übergeben, ändert diese Methode den Wert des Attributs in den von Ihnen angegebenen Wert. Wenn Sie für valueübergebennull, entfernt diese Methode das Attribut.

Diese Methode löst die Changed Ereignisse und aus Changing .

Der Wert wird dem Attribut mit dem angegebenen Namen zugewiesen. Wenn kein Attribut mit dem angegebenen Namen vorhanden ist, wird ein neues Attribut hinzugefügt. Wenn der Wert ist null, wird das Attribut mit dem angegebenen Namen gelöscht, falls vorhanden.

Weitere Informationen finden Sie unter Verwalten von Name-Wert-Paaren.

Gilt für:

Weitere Informationen