XmlAttributeCollection.InsertBefore メソッド

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

Public Overridable Function InsertBefore( _
   ByVal newNode As XmlAttribute, _   ByVal refNode As XmlAttribute _) As XmlAttribute
[C#]
public virtual XmlAttribute InsertBefore(XmlAttributenewNode,XmlAttributerefNode);
[C++]
public: virtual 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, C#, C++] ドキュメントに新しい属性を追加する例を次に示します。

 
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 <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
    XmlDocument* doc = new XmlDocument();
    doc->LoadXml(S"<book ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>");      

    //Create a new attribute.
    XmlAttribute* newAttr = doc->CreateAttribute(S"genre");
    newAttr->Value = S"novel";

    //Create an attribute collection and add the new attribute
    //to the collection.
    XmlAttributeCollection* attrColl = doc->DocumentElement->Attributes;
    attrColl->InsertBefore(newAttr, attrColl->ItemOf[0]);

    Console::WriteLine(S"Display the modified XML...\r\n");
    Console::WriteLine(doc->OuterXml);  
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

XmlAttributeCollection クラス | XmlAttributeCollection メンバ | System.Xml 名前空間