XmlAttributeCollection.InsertBefore メソッド

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

XmlAttributeCollection.InsertBefore メソッド

指定した属性を、指定した参照属性の直前に挿入します。

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

Visual Basic (宣言)

Public Function InsertBefore ( _
    newNode As XmlAttribute, _
    refNode As XmlAttribute _
) As XmlAttribute

Visual Basic (使用法)

Dim instance As XmlAttributeCollection
Dim newNode As XmlAttribute
Dim refNode As XmlAttribute
Dim returnValue As XmlAttribute

returnValue = instance.InsertBefore(newNode, refNode)

C#

public XmlAttribute InsertBefore (
    XmlAttribute newNode,
    XmlAttribute refNode
)

C++

public:
XmlAttribute^ InsertBefore (
    XmlAttribute^ newNode, 
    XmlAttribute^ refNode
)

J#

public XmlAttribute InsertBefore (
    XmlAttribute newNode, 
    XmlAttribute refNode
)

JScript

public function InsertBefore (
    newNode : XmlAttribute, 
    refNode : XmlAttribute
) : XmlAttribute

パラメータ

newNode

挿入する XmlAttribute。

refNode

参照属性である XmlAttribute。newNode は refNode の前に配置されます。

戻り値
コレクションに挿入する XmlAttribute。

例外

例外の種類	条件
ArgumentException	このコレクションを作成したドキュメントと異なるドキュメントから newNode が作成されました。または、refNode がこのコレクションのメンバではありません。

解説

同じ名前の属性がコレクション内に既に存在する場合は、元の属性がコレクションから削除され、newNode がコレクションに挿入されます。refNode が null 参照 (Visual Basic では Nothing) の場合は、newNode がコレクションの末尾に挿入されます。

このメソッドは、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.InsertBefore(newAttr, attrColl.ItemOf(0))

    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.InsertBefore(newAttr, attrColl[0]);

    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->InsertBefore( newAttr, attrColl[ 0 ] );
   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.InsertBefore(newAttr, attrColl.get_ItemOf(0));

        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 名前空間