Udostępnij za pośrednictwem


XElement.SetAttributeValue(XName, Object) Metoda

Definicja

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

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

Zobacz też