Udostępnij za pośrednictwem


XElement.SetElementValue(XName, Object) Metoda

Definicja

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

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

Zobacz też