XElement.SetAttributeValue(XName, Object) Methode

Definition

Namespace:
System.Xml.Linq
Assemblys:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblys:
netstandard.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
Quelle:
XElement.cs
Quelle:
XElement.cs
Quelle:
XElement.cs
Quelle:
XElement.cs
Quelle:
XElement.cs

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

Eine XName , die 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 ist null. Andernfalls wird der Wert in seine Zeichenfolgendarstellung konvertiert und der Value Eigenschaft des Attributs zugewiesen.

Ausnahmen

ArgumentException

Dies 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 ist so konzipiert, dass eine Liste von Namens-Wert-Paaren als Satz von Attributen leicht verwaltet werden kann. Beim Verwalten der Liste müssen Sie Paare hinzufügen, Paare ändern oder Paare löschen. Wenn Sie diese Methode aufrufen, die einen Namen übergibt, der nicht als Attribut vorhanden ist, erstellt diese Methode ein Attribut für Sie. Wenn Sie diese Methode aufrufen, die den Namen eines vorhandenen Attributs übergibt, ändert diese Methode den Wert des Attributs auf den von Ihnen angegebenen Wert. Wenn Sie diese Methode übergeben nullvalue, wird das Attribut entfernt.

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

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 lautet null, wird das Attribut mit dem angegebenen Namen (falls vorhanden) gelöscht.

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

Gilt für:

Weitere Informationen