XmlAttributeCollection.Append メソッド

.NET Framework クラス ライブラリ リファレンス

XmlAttributeCollection.Append メソッド

指定した属性をコレクション内の最後のノードとして挿入します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Function Append ( _
    node As XmlAttribute _
) As XmlAttribute

Visual Basic (使用法)

Dim instance As XmlAttributeCollection
Dim node As XmlAttribute
Dim returnValue As XmlAttribute

returnValue = instance.Append(node)

C#

public XmlAttribute Append (
    XmlAttribute node
)

C++

public:
XmlAttribute^ Append (
    XmlAttribute^ node
)

J#

public XmlAttribute Append (
    XmlAttribute node
)

JScript

public function Append (
    node : XmlAttribute
) : XmlAttribute

パラメータ

node

挿入する XmlAttribute。

戻り値
コレクションの末尾に追加する XmlAttribute。

例外

例外の種類	条件
ArgumentException	このコレクションを作成したドキュメントと異なるドキュメントからノードが作成されました。

解説

同じ名前の属性がコレクション内に既に存在する場合、元の属性がコレクションから削除され、ノードがコレクションの末尾に追加されます。

このメソッドは、DOM (Document Object Model) に対する Microsoft 拡張機能です。

使用例

ドキュメントに新しい属性を追加する例を次に示します。

Visual Basic

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.Append(newAttr)

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

  end sub
end class

C#

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);  
  }
}

C++

#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 );
}

J#

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        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.set_Value("novel");

        //Create an attribute collection and add the new attribute
        //to the collection.
        XmlAttributeCollection attrColl = 
            doc.get_DocumentElement().get_Attributes();
        attrColl.Append(newAttr);

        Console.WriteLine("Display the modified XML...\r\n");
        Console.WriteLine(doc.get_OuterXml());
    } //main
} //Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlAttributeCollection クラス
XmlAttributeCollection メンバ
System.Xml 名前空間