XmlAnyElementAttributeとは? わかりやすく解説

XmlAnyElementAttribute クラス

メンバ (XmlElement オブジェクトまたは XmlNode オブジェクトの配列を返すフィールド) に、シリアル化または逆シリアル化対象のオブジェクト内に対応するメンバがない任意の XML 要素を表すオブジェクトを含めるように指定します。

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

<AttributeUsageAttribute(AttributeTargets.Property Or AttributeTargets.Field
 Or AttributeTargets.Parameter Or AttributeTargets.ReturnValue,
 AllowMultiple:=True)> _
Public Class XmlAnyElementAttribute
    Inherits Attribute
Dim instance As XmlAnyElementAttribute
[AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 AllowMultiple=true)] 
public class XmlAnyElementAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Property|AttributeTargets::Field|AttributeTargets::Parameter|AttributeTargets::ReturnValue,
 AllowMultiple=true)] 
public ref class XmlAnyElementAttribute : public
 Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 AllowMultiple=true) */ 
public class XmlAnyElementAttribute extends
 Attribute
AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 AllowMultiple=true) 
public class XmlAnyElementAttribute extends
 Attribute
解説解説

XML ドキュメントに含まれるメタデータなど、XML ドキュメントの一部として送信される可能性がある任意のデータを XML 要素として含めるには、XmlAnyElementAttribute を使用します。

XmlAnyElementAttribute は、XmlElement オブジェクトまたは XmlNode オブジェクトの配列を返すフィールドに適用します。このようなフィールドは、オブジェクトがシリアル化されるか逆シリアル化されるかに応じて、2 つの方法で使用できます。シリアル化時には、オブジェクトは XML 要素または XML ノードとして生成されます。シリアル化対象のオブジェクト内にそれらの要素やノードに対応するメンバが存在するかどうかは関係ありません。この属性を適用するときに Name プロパティ値を指定した場合は、配列に挿入されるすべての XmlElement オブジェクトまたは XmlNode オブジェクトが、指定された同じ要素名と、同じ既定の名前空間を持っていることが必要です。それ以外の場合は、例外がスローされます。Namespace プロパティ値を設定した場合は、同様に Name プロパティも設定する必要があり、XmlElement オブジェクトまたは XmlNode オブジェクトの名前と名前空間の値がすべて同じであることが必要です。Name 値を指定しない場合は、任意の名前を持つ XmlElement オブジェクトまたは XmlNode オブジェクトを配列に含めることができます。

XmlSerializer クラスの Deserialize メソッドが呼び出されると、逆シリアル化対象のオブジェクト内に対応するメンバがない要素はすべて、配列にまとめられます。逆シリアル化が終了したら、XmlElement 項目のコレクションを反復処理して、データを処理できます。Name 値を指定すると、配列には、指定した名前の XML 要素だけが格納されます。Name 値を指定しない場合は、配列には、クラス内に対応するメンバがない要素がすべて格納されます。クラスに含まれている複数のフィールドにこの属性を適用する場合は、Name プロパティを使用するか、Name プロパティと Namespace プロパティを併用して、各配列の内容を区別できるようにする必要があります。このようなクラス (複数のフィールドが含まれている) に、配列を区別するためのプロパティ値 (つまり、Name と Namespace) が設定されていないフィールドが 1 つ含まれている場合、逆シリアル化時に、この配列には、他の配列には格納されない不明な XML 要素が格納されます。配列を区別するための Name 値、または Name 値と Namespace 値の組み合わせが設定されていないフィールドがクラス内に複数含まれている場合には、逆シリアル化時の動作は不定です。

XmlAnyElementAttribute は、単一の XmlElement オブジェクトを返すフィールドにも適用できます。その場合は、XmlElement クラスのプロパティとメソッドを使用して、不明な要素を繰り返し反復処理する必要があります。

XmlAnyElementAttribute の複数のインスタンスを 1 つのクラス メンバに適用できますが、各インスタンスには個別の Name プロパティ値を設定する必要があります。また、各インスタンスに同じ Name プロパティを設定した場合は、各インスタンスに設定する Namespace プロパティ値は個別にする必要があります。

XmlAnyElementAttribute をクラスのメンバに適用すると、XmlSerializer の UnknownNode イベントと UnknownAttribute イベントは発生しなくなります。

メモメモ

コードでは、XmlAnyElementAttribute の代わりに XmlAnyElement という短い語を使用できます。

属性の使用方法については、「属性を使用したメタデータの拡張」を参照してください。

使用例使用例

XmlElement オブジェクトの配列を返す AllElements という名前のフィールドに XmlAnyElementAttribute を適用する例を次に示します。

Public Class XClass
    ' Apply the XmlAnyElementAttribute to a field returning an array
    ' of XmlElement objects.
    <XmlAnyElement()> Public AllElements() As
 XmlElement
End Class 'XClass


Public Class Test
    
    Public Shared Sub Main()
        Dim t As New Test()
        t.DeserializeObject("XFile.xml")
    End Sub 'Main
    
    
    Private Sub DeserializeObject(filename
 As String)
        ' Create an XmlSerializer.
        Dim mySerializer As New
 XmlSerializer(GetType(XClass))
        
        ' To read a file, a FileStream is needed.
        Dim fs As New FileStream(filename,
 FileMode.Open)
        
        ' Deserialize the class.
        Dim x As XClass = CType(mySerializer.Deserialize(fs),
 XClass)
        
        ' Read the element names and values.
        Dim xel As XmlElement
        For Each xel In
  x.AllElements
            Console.WriteLine((xel.LocalName & ": "
 & xel.Value))
        Next xel
    End Sub 'DeserializeObject
End Class 'Test 
public class XClass
{
   /* Apply the XmlAnyElementAttribute to a field returning an array
   of XmlElement objects. */
   [XmlAnyElement]
   public XmlElement[] AllElements;
}

public class Test
{
   public static void Main()
   {
      Test t = new Test();
      t.DeserializeObject("XFile.xml");
   }

   private void DeserializeObject(string
 filename)
   {
      // Create an XmlSerializer.
      XmlSerializer mySerializer = new XmlSerializer(typeof(XClass));

      // To read a file, a FileStream is needed.
      FileStream fs = new FileStream(filename, FileMode.Open);

      // Deserialize the class.
      XClass x = (XClass) mySerializer.Deserialize(fs);

      // Read the element names and values.
      foreach(XmlElement xel in x.AllElements)
         Console.WriteLine(xel.LocalName + ": " + xel.Value);
   }
}
public ref class XClass
{
public:

   /* Apply the XmlAnyElementAttribute to a field returning an array
      of XmlElement objects. */

   [XmlAnyElement]
   array<XmlElement^>^AllElements;
};

public ref class Test
{
public:
   void DeserializeObject( String^ filename )
   {
      // Create an XmlSerializer.
      XmlSerializer^ mySerializer = gcnew XmlSerializer( XClass::typeid );

      // To read a file, a FileStream is needed.
      FileStream^ fs = gcnew FileStream( filename,FileMode::Open );

      // Deserialize the class.
      XClass^ x = dynamic_cast<XClass^>(mySerializer->Deserialize( fs ));

      // Read the element names and values.
      System::Collections::IEnumerator^ myEnum = x->AllElements->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         XmlElement^ xel = safe_cast<XmlElement^>(myEnum->Current);
         Console::WriteLine( "{0}: {1}", xel->LocalName, xel->Value
 );
      }
   }
};

int main()
{
   Test^ t = gcnew Test;
   t->DeserializeObject( "XFile.xml" );
}
public class XClass
{
    /* Apply the XmlAnyElementAttribute to a field returning an array
       of XmlElement objects. 
    */
    /** @attribute XmlAnyElement()
     */
    public XmlElement allElements[];
} //XClass

public class Test
{
    public static void main(String[]
 args)
    {
        Test t = new Test();
        t.DeserializeObject("XFile.xml");
    } //main

    private void DeserializeObject(String fileName)
    {
        // Create an XmlSerializer.
        XmlSerializer mySerializer = new XmlSerializer(XClass.class.ToType());

        // To read a file, a FileStream is needed.
        FileStream fs = new FileStream(fileName, FileMode.Open);

        // Deserialize the class.
        XClass x = (XClass)mySerializer.Deserialize(fs);

        // Read the element names and values.
        for (int iCtr = 0; iCtr < x.allElements.length;
 iCtr++) {
            XmlElement xel = (XmlElement)x.allElements.get_Item(iCtr);
            Console.WriteLine(xel.get_LocalName() + ": " + xel.get_Value());
        }
    } //DeserializeObject
} //Test
継承階層継承階層
System.Object
   System.Attribute
    System.Xml.Serialization.XmlAnyElementAttribute
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlAnyElementAttribute メンバ
System.Xml.Serialization 名前空間
XmlAnyAttributeAttribute クラス
その他の技術情報
XML シリアル化の概要

XmlAnyElementAttribute コンストラクタ ()

XmlAnyElementAttribute クラスの新しいインスタンスを初期化します。

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

Dim instance As New XmlAnyElementAttribute
public XmlAnyElementAttribute ()
public:
XmlAnyElementAttribute ()
public XmlAnyElementAttribute ()
public function XmlAnyElementAttribute ()
解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlAnyElementAttribute クラス
XmlAnyElementAttribute メンバ
System.Xml.Serialization 名前空間

XmlAnyElementAttribute コンストラクタ (String, String)

XmlAnyElementAttribute クラスの新しいインスタンスを初期化し、XML ドキュメントに生成される XML 要素名とその XML 名前空間を指定します。

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

Dim name As String
Dim ns As String

Dim instance As New XmlAnyElementAttribute(name,
 ns)
public XmlAnyElementAttribute (
    string name,
    string ns
)
public:
XmlAnyElementAttribute (
    String^ name, 
    String^ ns
)
public XmlAnyElementAttribute (
    String name, 
    String ns
)
public function XmlAnyElementAttribute (
    name : String, 
    ns : String
)

パラメータ

name

XmlSerializer が生成する XML 要素の名前。

ns

XML 要素の XML 名前空間。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlAnyElementAttribute クラス
XmlAnyElementAttribute メンバ
System.Xml.Serialization 名前空間

XmlAnyElementAttribute コンストラクタ

XmlAnyElementAttribute クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

参照参照

関連項目

XmlAnyElementAttribute クラス
XmlAnyElementAttribute メンバ
System.Xml.Serialization 名前空間

XmlAnyElementAttribute コンストラクタ (String)

XmlAnyElementAttribute クラスの新しいインスタンスを初期化し、XML ドキュメントに生成される XML 要素名を指定します。

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

Dim name As String

Dim instance As New XmlAnyElementAttribute(name)
public XmlAnyElementAttribute (
    string name
)
public:
XmlAnyElementAttribute (
    String^ name
)
public XmlAnyElementAttribute (
    String name
)
public function XmlAnyElementAttribute (
    name : String
)

パラメータ

name

XmlSerializer が生成する XML 要素の名前。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlAnyElementAttribute クラス
XmlAnyElementAttribute メンバ
System.Xml.Serialization 名前空間

XmlAnyElementAttribute プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ .NET Compact Framework によるサポート .NET Compact Framework によるサポート .NET Compact Framework によるサポート TypeId  派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
参照参照

関連項目

XmlAnyElementAttribute クラス
System.Xml.Serialization 名前空間
XmlAnyAttributeAttribute クラス

その他の技術情報

XML シリアル化の概要

XmlAnyElementAttribute メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 ( Attribute から継承されます。)
パブリック メソッド GetCustomAttribute  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
パブリック メソッド GetCustomAttributes  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
パブリック メソッド GetHashCode  このインスタンスのハッシュ コードを返します。 ( Attribute から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド IsDefaultAttribute  派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
パブリック メソッド IsDefined  オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
パブリック メソッド Match  派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

XmlAnyElementAttribute クラス
System.Xml.Serialization 名前空間
XmlAnyAttributeAttribute クラス

その他の技術情報

XML シリアル化の概要

XmlAnyElementAttribute メンバ

メンバ (XmlElement オブジェクトまたは XmlNode オブジェクトの配列を返すフィールド) に、シリアル化または逆シリアル化対象のオブジェクト内に対応するメンバがない任意の XML 要素を表すオブジェクトを含めるように指定します。

XmlAnyElementAttribute データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド XmlAnyElementAttribute オーバーロードされます。 XmlAnyElementAttribute クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ .NET Compact Framework によるサポート .NET Compact Framework によるサポート .NET Compact Framework によるサポート TypeId  派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 ( Attribute から継承されます。)
パブリック メソッド GetCustomAttribute  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
パブリック メソッド GetCustomAttributes  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
パブリック メソッド GetHashCode  このインスタンスのハッシュ コードを返します。 (Attribute から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド IsDefaultAttribute  派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
パブリック メソッド IsDefined  オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
パブリック メソッド Match  派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

XmlAnyElementAttribute クラス
System.Xml.Serialization 名前空間
XmlAnyAttributeAttribute クラス

その他の技術情報

XML シリアル化の概要



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「XmlAnyElementAttribute」の関連用語

XmlAnyElementAttributeのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



XmlAnyElementAttributeのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS