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

Определение

Пространство имен:

System.Xml.Linq

Сборка:

System.Xml.XDocument.dll

Сборка:

System.Xml.Linq.dll

Сборка:

netstandard.dll

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

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>  

Комментарии

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

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

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

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

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

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

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• Общие сведения о LINQ to XML
• Обслуживание пар "имя — значение"