XElement.SetAttributeValue(XName, Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.Linq

Zestaw:: System.Xml.XDocument.dll

Zestaw:: System.Xml.Linq.dll

Zestaw:: netstandard.dll

Źródło:: XElement.cs

Źródło:: XElement.cs

Źródło:: XElement.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Ustawia wartość atrybutu, dodaje atrybut lub usuwa atrybut.

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)

Parametry

name: XName

Element XName zawierający nazwę atrybutu do zmiany.

value: Object

Wartość, która ma zostać przypisana do atrybutu. Atrybut jest usuwany, jeśli wartość to null. W przeciwnym razie wartość jest konwertowana na reprezentację ciągu i przypisana Value do właściwości atrybutu.

Wyjątki

ArgumentException

Jest value to wystąpienie klasy XObject.

Przykłady

Poniższy przykład tworzy element z atrybutem . Następnie używa tej metody do zastąpienia zawartości atrybutu.

// 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)

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda została zaprojektowana w celu ułatwienia obsługi listy par nazwa/wartość jako zestawu atrybutów. Podczas obsługi listy należy dodać pary, zmodyfikować pary lub usunąć pary. Jeśli wywołasz tę metodę przekazującą nazwę, która nie istnieje jako atrybut, ta metoda utworzy atrybut. Jeśli wywołasz tę metodę przekazującą nazwę istniejącego atrybutu, ta metoda modyfikuje wartość atrybutu do określonej wartości. Jeśli przekażesz null wartość value, ta metoda usunie atrybut .

Ta metoda spowoduje wywołanie zdarzeń Changed i Changing .

Wartość jest przypisywana do atrybutu o określonej nazwie. Jeśli nie istnieje żaden atrybut o określonej nazwie, zostanie dodany nowy atrybut. Jeśli wartość to null, atrybut o określonej nazwie, jeśli istnieje, zostanie usunięty.

Aby uzyskać więcej informacji, zobacz Obsługa par nazwa-wartość.

Dotyczy