XmlAttributeCollection.SetNamedItem(XmlNode) XmlAttributeCollection.SetNamedItem(XmlNode) XmlAttributeCollection.SetNamedItem(XmlNode) XmlAttributeCollection.SetNamedItem(XmlNode) Method

Определение

Добавляет узел XmlNode с помощью свойства NameAdds a XmlNode using its Name property

public:
 override System::Xml::XmlNode ^ SetNamedItem(System::Xml::XmlNode ^ node);
public override System.Xml.XmlNode SetNamedItem (System.Xml.XmlNode node);
override this.SetNamedItem : System.Xml.XmlNode -> System.Xml.XmlNode
Public Overrides Function SetNamedItem (node As XmlNode) As XmlNode

Параметры

node
XmlNode XmlNode XmlNode XmlNode

узел атрибута, предназначенный для помещения в коллекцию.An attribute node to store in this collection. Позже узел будет доступен по своему имени.The node will later be accessible using the name of the node. Если узел с таким именем уже присутствует в коллекции, он замещается новым; в противном случае узел добавляется в конец коллекции.If a node with that name is already present in the collection, it is replaced by the new one; otherwise, the node is appended to the end of the collection.

Возвраты

Если узел node заменяет существующий узел с таким же именем, то возвращается старый узел; в противном случае возвращается добавленный узел.If the node replaces an existing node with the same name, the old node is returned; otherwise, the added node is returned.

Исключения

node был создан из XmlDocument, отличающегося от того, который создал данную коллекцию.node was created from a different XmlDocument than the one that created this collection.

Этот объект XmlAttributeCollection доступен только для чтения.This XmlAttributeCollection is read-only.

node представляет собой XmlAttribute, который уже является атрибутом другого объекта XmlElement.node is an XmlAttribute that is already an attribute of another XmlElement object. Для повторного использования атрибутов в других элементах необходимо клонировать объекты XmlAttribute, которые требуется повторно использовать.To re-use attributes in other elements, you must clone the XmlAttribute objects you want to re-use.

Примеры

В следующем примере в документ добавляется новый атрибут.The following example adds a new attribute to a document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   
   //Create a new attribute.
   XmlAttribute^ newAttr = doc->CreateAttribute( "genre" );
   newAttr->Value = "novel";
   
   //Create an attribute collection and add the new attribute
   //to the collection.
   XmlAttributeCollection^ attrColl = doc->DocumentElement->Attributes;
   attrColl->SetNamedItem( newAttr );
   Console::WriteLine( "Display the modified XML...\r\n" );
   Console::WriteLine( doc->OuterXml );
}

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

public class Sample
{
  public static void Main(){
  
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");      

    //Create a new attribute.
    XmlAttribute newAttr = doc.CreateAttribute("genre");
    newAttr.Value = "novel";

    //Create an attribute collection and add the new attribute
    //to the collection.
    XmlAttributeCollection attrColl = doc.DocumentElement.Attributes;
    attrColl.SetNamedItem(newAttr);

    Console.WriteLine("Display the modified XML...\r\n");
    Console.WriteLine(doc.OuterXml);  
  }
}
Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book ISBN='1-861001-57-5'>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>")      

    'Create a new attribute.
    Dim newAttr as XmlAttribute = doc.CreateAttribute("genre")
    newAttr.Value = "novel"

    'Create an attribute collection and add the new attribute
    'to the collection.  
    Dim attrColl as XmlAttributeCollection = doc.DocumentElement.Attributes
    attrColl.SetNamedItem(newAttr)

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

  end sub
end class

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