XmlAttributeCollection.Append(XmlAttribute) 方法

定义

将指定的特性插入集合,并将其作为集合中的最后一个节点。Inserts the specified attribute as the last node in the collection.

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

参数

node
XmlAttribute

要插入的属性。The attribute to insert.

返回

XmlAttribute

追加到集合末尾的 XmlAttributeThe XmlAttribute to append to the collection.

例外

node 是从创建此集合的文档之外的另一个文档创建的。node was created from a document different from the one that created this collection.

示例

下面的示例向文档中添加了一个新属性。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->Append( 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.Append(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.Append(newAttr)

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

  end sub
end class

注解

如果集合中已存在具有相同名称的属性,则将从集合中删除原始属性,并将其 node 添加到集合的末尾。If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and node is added to the end of the collection.

此方法是文档对象模型 (DOM) 的 Microsoft 扩展。This method is a Microsoft extension to the Document Object Model (DOM).

适用于