XElement.SetElementValue(XName, Object) Метод

Определение

Пространство имен:
System.Xml.Linq
Сборки:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Сборки:
netstandard.dll, System.Xml.XDocument.dll
Сборка:
System.Xml.XDocument.dll
Сборка:
System.Xml.Linq.dll
Сборка:
netstandard.dll
Исходный код:
XElement.cs
Исходный код:
XElement.cs
Исходный код:
XElement.cs
Исходный код:
XElement.cs
Исходный код:
XElement.cs

Задает значение дочернего элемента, добавляет дочерний элемент или удаляет дочерний элемент.

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)

Параметры

name
XName

Значение XName , содержащее имя дочернего элемента для изменения.

value
Object

Значение для назначения дочернему элементу. Дочерний элемент удаляется, если значение равно null. В противном случае значение преобразуется в строковое представление и назначается Value свойству дочернего элемента.

Исключения

ArgumentException

Это value экземпляр XObject.

Примеры

В следующем примере создается элемент с дочерним элементом. Затем этот метод используется для задания значения дочернего элемента.

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

В примере получается следующий вывод.

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

Комментарии

Этот метод предназначен для упрощения поддержания списка пар name/value в виде набора дочерних элементов. При сохранении списка необходимо добавить пары, изменить пары или удалить пары. При вызове этого метода, передавающего имя, которое не существует в качестве дочернего элемента, этот метод создает дочерний элемент для вас. При вызове этого метода, передавающего имя существующего дочернего элемента, этот метод изменяет значение дочернего элемента на указанное значение. При передаче nullvalueэтот метод удаляет дочерний элемент.

Этот метод вызывает события.

Значение назначается первому дочернему элементу с указанным именем. Если дочерний элемент с указанным именем не существует, добавляется новый дочерний элемент. Если значение равно NULL, первый дочерний элемент с указанным именем, если таковой имеется, удаляется.

Этот метод не добавляет дочерние узлы или атрибуты в указанный дочерний элемент. Этот метод создает исключение, если какой-либо объект, производный от передаваемого как XObjectvalue.

Дополнительные сведения см. в разделе "Обслуживание пар "имя-значение".

Применяется к

См. также раздел