XmlAttributeCollection.Append(XmlAttribute) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.dll, System.Xml.XmlDocument.dll

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.XmlDocument.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

将指定的特性插入集合，并将其作为集合中的最后一个节点。

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

要插入的属性。

返回

XmlAttribute

追加到集合末尾的 XmlAttribute。

例外

ArgumentException

node 是从创建此集合的文档之外的另一个文档创建的。

示例

以下示例向文档添加新属性。

#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 添加到集合末尾。

此方法是文档对象模型的 Microsoft 扩展， (DOM) 。