XmlAttributeCollection.SetNamedItem メソッド

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

XmlAttributeCollection.SetNamedItem メソッド

Name プロパティを使用して XmlNode を追加します。

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

Visual Basic (宣言)

Public Overrides Function
 SetNamedItem ( _
    node As XmlNode _
) As XmlNode

Visual Basic (使用法)

Dim instance As XmlAttributeCollection
Dim node As XmlNode
Dim returnValue As XmlNode

returnValue = instance.SetNamedItem(node)

C#

public override XmlNode SetNamedItem (
    XmlNode node
)

C++

public:
virtual XmlNode^ SetNamedItem (
    XmlNode^ node
) override

J#

public XmlNode SetNamedItem (
    XmlNode node
)

JScript

public override function SetNamedItem (
    node : XmlNode
) : XmlNode

パラメータ

node

このコレクションに格納する属性ノード。このノードは、ノードの名前を使用すると後からアクセスできます。その名前のノードが既にコレクションに存在している場合は、新しいノードと置き換えられます。それ以外の場合は、ノードがコレクションの末尾に追加されます。

戻り値
ノードによって同じ名前の既存のノードが置換される場合は、古いノードが返されます。それ以外の場合は、追加されたノードが返されます。

例外

例外の種類	条件
ArgumentException	このコレクションを作成した XML ドキュメントと異なる XmlDocument から node が作成されました。 この XmlAttributeCollection は読み取り専用です。
InvalidOperationException	node は、既に別の XmlElement オブジェクトの属性である XmlAttribute です。その他の要素の属性を再利用するには、再利用する XmlAttribute オブジェクトのクローンを作成する必要があります。

使用例

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

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