XElement.SetAttributeValue(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 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)

Параметры

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

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

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

Комментарии

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

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

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

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

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

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