XmlAttributeCollection.SetNamedItem(XmlNode) Methode

Definition

Fügt einen XmlNode unter Verwendung der entsprechenden Name-Eigenschaft hinzu.Adds 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

Parameter

node
XmlNode

Ein in dieser Auflistung zu speichernder Attributknoten.An attribute node to store in this collection. Auf den Knoten kann später mit dem Namen des Knotens zugegriffen werden.The node will later be accessible using the name of the node. Wenn ein Knoten mit diesem Namen bereits in der Auflistung enthalten ist, wird er durch den neuen ersetzt, andernfalls wird der Knoten am Ende der Auflistung angehängt.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.

Gibt zurück

Wenn der node einen vorhandenen Knoten mit demselben Namen ersetzt, wird der alte Knoten zurückgegeben, andernfalls wird hinzugefügte Knoten zurückgegeben.If the node replaces an existing node with the same name, the old node is returned; otherwise, the added node is returned.

Ausnahmen

node wurde aus einem anderen XmlDocument als dem erstellt, das diese Auflistung erstellt hat.node was created from a different XmlDocument than the one that created this collection.

Diese XmlAttributeCollection ist schreibgeschützt.This XmlAttributeCollection is read-only.

node ist ein XmlAttribute, das bereits ein Attribut eines anderen XmlElement-Objekts ist.node is an XmlAttribute that is already an attribute of another XmlElement object. Wenn Attribute in anderen Elementen wiederverwendet werden sollen, müssen Sie die wiederzuverwendenden XmlAttribute-Objekte klonen.To re-use attributes in other elements, you must clone the XmlAttribute objects you want to re-use.

Beispiele

Im folgenden Beispiel wird einem Dokument ein neues Attribut hinzugefügt.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.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

Gilt für: