XmlElement.SetAttributeNode Метод

  • Ссылка

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.XmlDocument.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.XmlDocument.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

Добавляет новый объект XmlAttribute.

Перегрузки

SetAttributeNode(XmlAttribute)

Добавляет заданный объект XmlAttribute.
SetAttributeNode(String, String)

Добавляет заданный объект XmlAttribute.

SetAttributeNode(XmlAttribute)

Добавляет заданный объект XmlAttribute.

public:
 virtual System::Xml::XmlAttribute ^ SetAttributeNode(System::Xml::XmlAttribute ^ newAttr);
public virtual System.Xml.XmlAttribute SetAttributeNode (System.Xml.XmlAttribute newAttr);
public virtual System.Xml.XmlAttribute? SetAttributeNode (System.Xml.XmlAttribute newAttr);
abstract member SetAttributeNode : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
override this.SetAttributeNode : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
Public Overridable Function SetAttributeNode (newAttr As XmlAttribute) As XmlAttribute

Параметры

newAttr
XmlAttribute

Узел XmlAttribute для добавления в коллекцию атрибутов этого элемента.

Возвращаемое значение

XmlAttribute

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

Исключения

ArgumentException

Узел newAttr был создан из другого документа, отличного от документа, из которого был создан этот узел. Или этот узел доступен только для чтения.

InvalidOperationException

Узел newAttr уже является атрибутом другого объекта XmlElement. Необходимо явно создать точную копию узлов XmlAttribute для их повторного использования в других объектах XmlElement.

Комментарии

Если атрибут с таким именем уже присутствует в элементе, он заменяется новым.

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

SetAttributeNode(String, String)

Добавляет заданный объект XmlAttribute.

public:
 virtual System::Xml::XmlAttribute ^ SetAttributeNode(System::String ^ localName, System::String ^ namespaceURI);
public virtual System.Xml.XmlAttribute SetAttributeNode (string localName, string namespaceURI);
public virtual System.Xml.XmlAttribute SetAttributeNode (string localName, string? namespaceURI);
abstract member SetAttributeNode : string * string -> System.Xml.XmlAttribute
override this.SetAttributeNode : string * string -> System.Xml.XmlAttribute
Public Overridable Function SetAttributeNode (localName As String, namespaceURI As String) As XmlAttribute

Параметры

localName
String

Локальное имя атрибута.

namespaceURI
String

Универсальный код ресурса (URI) пространства имен атрибута.

Возвращаемое значение

XmlAttribute

Добавляемый объект XmlAttribute.

Примеры

В следующем примере атрибут добавляется в элемент.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   XmlElement^ root = doc->DocumentElement;
   
   // Add a new attribute.
   XmlAttribute^ attr = root->SetAttributeNode( "genre", "urn:samples" );
   attr->Value = "novel";
   Console::WriteLine( "Display the modified XML..." );
   Console::WriteLine( doc->InnerXml );
}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlElement root = doc.DocumentElement;

    // Add a new attribute.
    XmlAttribute attr = root.SetAttributeNode("genre", "urn:samples");
    attr.Value="novel";

    Console.WriteLine("Display the modified XML...");
    Console.WriteLine(doc.InnerXml);
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>")

    Dim root as XmlElement = doc.DocumentElement

    ' Add a new attribute.
    Dim attr as XmlAttribute = root.SetAttributeNode("genre", "urn:samples")
    attr.Value="novel"

    Console.WriteLine("Display the modified XML...")
    Console.WriteLine(doc.InnerXml)

  end sub
end class

Комментарии

У XmlAttribute него нет детей. Используется Value для назначения текстового значения атрибуту или использования AppendChild (или аналогичного метода) для добавления дочерних элементов к атрибуту.

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