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

Определение

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

System.Xml.Linq

Сборка:

System.Xml.XDocument.dll

Исходный код:

XElement.cs

Устанавливает значение атрибута, добавляет или удаляет атрибут.

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::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" />

Комментарии

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

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

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

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

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

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