XElement.SetElementValue(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ść elementu podrzędnego, dodaje element podrzędny lub usuwa element podrzędny.

public:
 void SetElementValue(System::Xml::Linq::XName ^ name, System::Object ^ value);

public void SetElementValue (System.Xml.Linq.XName name, object value);

public void SetElementValue (System.Xml.Linq.XName name, object? value);

member this.SetElementValue : System.Xml.Linq.XName * obj -> unit

Public Sub SetElementValue (name As XName, value As Object)

Parametry

name: XName

Element XName zawierający nazwę elementu podrzędnego do zmiany.

value: Object

Wartość do przypisania do elementu podrzędnego. Element podrzędny jest usuwany, jeśli wartość to null. W przeciwnym razie wartość jest konwertowana na reprezentację ciągu i przypisana do Value właściwości elementu podrzędnego.

Wyjątki

ArgumentException

Jest value to wystąpienie klasy XObject.

Przykłady

Poniższy przykład tworzy element z elementem podrzędnym. Następnie używa tej metody do ustawiania wartości elementu podrzędnego.

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

// Add some name/value pairs.
root.SetElementValue("Ele1", 1);
root.SetElementValue("Ele2", 2);
root.SetElementValue("Ele3", 3);
Console.WriteLine(root);

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

// Remove one of the name/value pairs.
root.SetElementValue("Ele3", null);
Console.WriteLine(root);

' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetElementValue("Ele1", 1)
root.SetElementValue("Ele2", 2)
root.SetElementValue("Ele3", 3)
Console.WriteLine(root)

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

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

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

<Root>
  <Ele1>1</Ele1>
  <Ele2>2</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
</Root>

Uwagi

Ta metoda została zaprojektowana w celu ułatwienia obsługi listy par nazw/wartości jako zestawu elementów podrzędnych. 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 element podrzędny, ta metoda tworzy dla Ciebie element podrzędny. Jeśli wywołasz tę metodę przekazującą nazwę istniejącego elementu podrzędnego, ta metoda modyfikuje wartość elementu podrzędnego do określonej wartości. Jeśli przejdziesz null dla valuemetody , ta metoda usunie element podrzędny.

Ta metoda spowoduje wywołanie zdarzeń.

Wartość jest przypisywana do pierwszego elementu podrzędnego o określonej nazwie. Jeśli nie istnieje element podrzędny o określonej nazwie, zostanie dodany nowy element podrzędny. Jeśli wartość ma wartość null, zostanie usunięty pierwszy element podrzędny o określonej nazwie, jeśli istnieje.

Ta metoda nie dodaje węzłów podrzędnych ani atrybutów do określonego elementu podrzędnego. Ta metoda zgłasza wyjątek, jeśli jakikolwiek obiekt pochodzący z XObject metody jest przekazywany jako value.

Aby uzyskać więcej informacji, zobacz Obsługa par name-value.

Dotyczy