XmlAnyElementAttributes XmlAnyElementAttributes XmlAnyElementAttributes XmlAnyElementAttributes Class

定義

XmlAnyElementAttribute オブジェクトのコレクションを表します。Represents a collection of XmlAnyElementAttribute objects.

public ref class XmlAnyElementAttributes : System::Collections::CollectionBase
public class XmlAnyElementAttributes : System.Collections.CollectionBase
type XmlAnyElementAttributes = class
    inherit CollectionBase
Public Class XmlAnyElementAttributes
Inherits CollectionBase
継承
XmlAnyElementAttributesXmlAnyElementAttributesXmlAnyElementAttributesXmlAnyElementAttributes

次の例では、 XmlAnyElementAttribute新しいを作成し、 XmlAnyElementsプロパティを通じてアクセスされるオブジェクトのコレクションに追加します。The following example creates a new XmlAnyElementAttribute and adds it to the collection of objects accessed through the XmlAnyElements property. XmlAttributes XmlSerializerに、を作成するために使用されるに追加されます。 XmlAttributeOverridesThe XmlAttributes is then added to a XmlAttributeOverrides which is used to create an XmlSerializer. XmlSerializer 、オブジェクトをシリアル化または逆シリアル化するために使用されます。The XmlSerializer is used to serialize or deserialize an object. XmlAnyElementAttributesプロパティを使用した場合の影響を確認するには、 MainメソッドでSerializeObjectメソッドを実行して、UnknownElements という名前の xml ドキュメントを作成します。To see the effect of using the XmlAnyElementAttributes property, create an XML document named UnknownElements.xml by running the SerializeObject method in the Main method. 結果のドキュメントを編集して、他の (不明な) 要素を含めます。Edit the resulting document to include other (unknown) elements. MainメソッドのSerializeObject呼び出しをコメントアウトし、メソッドのDeserializeObject呼び出しをコメント解除します。これにより、不明な XML 要素の名前と値が出力されます。Comment out the SerializeObject call in the Main method, and uncomment the call to the DeserializeObject method, which prints out the name and value of any unknown XML element.

#using <System.dll>
#using <System.xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Xml;
public ref class Group
{
public:
   String^ GroupName;

   [XmlAnyElement]
   array<Object^>^Things;
};

void SerializeObject( String^ filename );
void DeserializeObject( String^ filename );
XmlSerializer^ CreateOverrideSerializer();
int main()
{
   // 1 Run this and create the XML document.
   // 2 Add new elements to the XML document.
   // 3 Comment out the next line, and uncomment
   // the DeserializeObject line to deserialize the
   // XML document and see unknown elements.
   SerializeObject( "UnknownElements.xml" );

   // DeserializeObject(S"UnknownElements.xml");
}

void SerializeObject( String^ filename )
{
   XmlSerializer^ ser = gcnew XmlSerializer( Group::typeid );
   TextWriter^ writer = gcnew StreamWriter( filename );
   Group^ g = gcnew Group;
   g->GroupName = "MyGroup";
   ser->Serialize( writer, g );
   writer->Close();
}

void DeserializeObject( String^ filename )
{
   XmlSerializer^ ser = CreateOverrideSerializer();

   // A FileStream is needed to read the XML document.
   FileStream^ fs = gcnew FileStream( filename,FileMode::Open );
   Group^ g = safe_cast<Group^>(ser->Deserialize( fs ));
   fs->Close();
   Console::WriteLine( g->GroupName );
   Console::WriteLine( g->Things->Length );
   for ( int i = 0; i < g->Things->Length; ++i )
   {
      XmlElement^ xelement = safe_cast<XmlElement^>(g->Things[ i ]);
      Console::WriteLine( "{0}: {1}", xelement->Name, xelement->InnerXml );
   }
}

XmlSerializer^ CreateOverrideSerializer()
{
   XmlAnyElementAttribute^ myAnyElement = gcnew XmlAnyElementAttribute;
   XmlAttributeOverrides^ xOverride = gcnew XmlAttributeOverrides;
   XmlAttributes^ xAtts = gcnew XmlAttributes;
   xAtts->XmlAnyElements->Add( myAnyElement );
   xOverride->Add( Group::typeid, "Things", xAtts );
   return gcnew XmlSerializer( Group::typeid,xOverride );
}
using System;
using System.IO;
using System.Xml.Serialization;
using System.Xml;

public class Group{
   public string GroupName;
   [XmlAnyElement]
   public object[]Things;

}

public class Test{
   static void Main(){
      Test t = new Test();
      // 1 Run this and create the XML document.
      // 2 Add new elements to the XML document.
      // 3 Comment out the new line, and uncomment
      // the DeserializeObject line to deserialize the
      // XML document and see unknown elements.
      t.SerializeObject("UnknownElements.xml");
     
      // t.DeserializeObject("UnknownElements.xml");
   }

   private void SerializeObject(string filename){
      XmlSerializer ser = new XmlSerializer(typeof (Group));
      TextWriter writer = new StreamWriter(filename);
      Group g = new Group();
      g.GroupName = "MyGroup";
      ser.Serialize(writer, g);
      writer.Close();
   }

   
   private void DeserializeObject(string filename){

      XmlSerializer ser = CreateOverrideSerializer();
      // A FileStream is needed to read the XML document.
      FileStream fs = new FileStream(filename, FileMode.Open);
     Group g = (Group)
     	ser.Deserialize(fs);
     fs.Close();
     Console.WriteLine(g.GroupName);
     Console.WriteLine(g.Things.Length);
     foreach(XmlElement xelement in g.Things){
     Console.WriteLine(xelement.Name + ": " + xelement.InnerXml);
     }
   }

   private XmlSerializer CreateOverrideSerializer(){
      XmlAnyElementAttribute myAnyElement = 
      new XmlAnyElementAttribute();
      XmlAttributeOverrides xOverride = 
      new XmlAttributeOverrides();
      XmlAttributes xAtts = new XmlAttributes();
      xAtts.XmlAnyElements.Add(myAnyElement);
      xOverride.Add(typeof(Group), "Things", xAtts);
      return new XmlSerializer(typeof(Group) , xOverride);
   }
}
Imports System.IO
Imports System.Xml.Serialization
Imports System.Xml

Public Class Group
   Public GroupName As String 
   <XmlAnyElement> _
   Public Things () As object
End Class

Public Class Test
   Shared Sub Main()
      Dim t As Test = New Test()
      ' 1 Run this and create the XML document.
      ' 2 Add New elements to the XML document.
      ' 3 Comment out the New line, and uncomment
      ' the DeserializeObject line to deserialize the
      ' XML document and see unknown elements.
     t.SerializeObject("UnknownElements.xml")
     
      't.DeserializeObject("UnknownElements.xml")
   End Sub

   Private Sub SerializeObject(filename As String)
      Dim ser As XmlSerializer = New XmlSerializer(GetType (Group))
      Dim writer As TextWriter = New StreamWriter(filename)
      
      Dim g As Group = New Group()
      g.GroupName = "MyGroup"
      ser.Serialize(writer, g)
      writer.Close()
   End Sub

   
   Private Sub DeserializeObject(filename As String)

      Dim ser As XmlSerializer = CreateOverrideSerializer()
      ' A FileStream is needed to read the XML document.
      Dim fs As FileStream = New FileStream(filename, FileMode.Open)
     Dim g As Group = CType( _
     	ser.Deserialize(fs), Group)
     fs.Close()
     Console.WriteLine(g.GroupName)
     Console.WriteLine(g.Things.Length)
     Dim xelement As XmlELement
     for each xelement in g.Things
        Console.WriteLine(xelement.Name &": " & xelement.InnerXml)
     next
   End Sub
   

   Private Function CreateOverrideSerializer() As XmlSerializer 
      Dim myAnyElement As XmlAnyElementAttribute = _
      New XmlAnyElementAttribute()
      Dim xOverride As XmlAttributeOverrides = _
      New XmlAttributeOverrides()
      Dim xAtts As XmlAttributes = New XmlAttributes()
      xAtts.XmlAnyElements.Add(myAnyElement)
      xOverride.Add(GetType(Group), "Things", xAtts)
      return New XmlSerializer(GetType(Group) , xOverride)
   End Function
End Class

注釈

オブジェクトのXmlAnyElementAttributes XmlAnyElementAttributeセットの動作をオーバーライドするには、を使用します。Use the XmlAnyElementAttributes to override the behavior of a set of XmlAnyElementAttribute objects. 各インスタンスに個別XmlAnyElementAttribute Nameのプロパティ値がある限り、クラスの複数のインスタンスをクラスメンバーに適用できます。これによりXmlSerializer 、は、指定された要素の下の不明な要素を適切な配列に収集するように指示します。Multiple instances of the XmlAnyElementAttribute class can be applied to a class member, as long as each instance has a distinct Name property value; this instructs the XmlSerializer to collect unknown elements under the named element into the appropriate array. これは、 XmlAnyElementAttribute XmlAnyElementAttributesクラスの複数のインスタンスをに追加できるためです。It is for this reason that multiple instances of the XmlAnyElementAttribute class can be added to the XmlAnyElementAttributes.

一連のオブジェクトをオーバーライドXmlAnyElementAttributeするには、次のようにします。To override a set of XmlAnyElementAttribute objects:

  1. XmlAnyElementAttributes作成します。Create an XmlAnyElementAttributes.

  2. オブジェクトのXmlAnyElementAttributeセットを作成し、 Addメソッドを使用して各オブジェクトをコレクションに追加します。Create the set of XmlAnyElementAttribute objects, and add each object to the collection using the Add method.

  3. XmlAttributes作成します。Create an XmlAttributes.

  4. プロパティをに設定します。XmlAnyElements XmlAnyElementAttributesSet the XmlAnyElements property to the XmlAnyElementAttributes.

  5. XmlAttributeOverrides作成します。Create an XmlAttributeOverrides.

  6. メソッドをXmlAttributeOverrides使用してXmlAttributes 、をに追加Addします。Add the XmlAttributes to the XmlAttributeOverrides using the Add method.

  7. XmlSerializerXmlAttributeOverrides使用して、のインスタンスを作成します。Create an instance of the XmlSerializer using the XmlAttributeOverrides.

  8. オブジェクトのXmlAnyElementAttributeセットを含むオブジェクトをシリアル化または逆シリアル化します。Serialize or deserialize an object that contains the set of XmlAnyElementAttribute objects.

コンストラクター

XmlAnyElementAttributes() XmlAnyElementAttributes() XmlAnyElementAttributes() XmlAnyElementAttributes()

XmlAnyElementAttributes クラスの新しいインスタンスを初期化します。Initializes a new instance of the XmlAnyElementAttributes class.

プロパティ

Capacity Capacity Capacity Capacity

CollectionBase に格納できる要素の数を取得または設定します。Gets or sets the number of elements that the CollectionBase can contain.

(Inherited from CollectionBase)
Count Count Count Count
InnerList InnerList InnerList InnerList

ArrayList インスタンス内の要素のリストを格納する CollectionBase を取得します。Gets an ArrayList containing the list of elements in the CollectionBase instance.

(Inherited from CollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

指定したインデックス位置にある XmlAnyElementAttribute を取得または設定します。Gets or sets the XmlAnyElementAttribute at the specified index.

List List List List

IList インスタンス内の要素のリストを格納する CollectionBase を取得します。Gets an IList containing the list of elements in the CollectionBase instance.

(Inherited from CollectionBase)

メソッド

Add(XmlAnyElementAttribute) Add(XmlAnyElementAttribute) Add(XmlAnyElementAttribute) Add(XmlAnyElementAttribute)

XmlAnyElementAttribute をコレクションに追加します。Adds an XmlAnyElementAttribute to the collection.

Clear() Clear() Clear() Clear()
Contains(XmlAnyElementAttribute) Contains(XmlAnyElementAttribute) Contains(XmlAnyElementAttribute) Contains(XmlAnyElementAttribute)

指定した XmlAnyElementAttribute がコレクション内に存在するかどうかを示す値を取得します。Gets a value that indicates whether the specified XmlAnyElementAttribute exists in the collection.

CopyTo(XmlAnyElementAttribute[], Int32) CopyTo(XmlAnyElementAttribute[], Int32) CopyTo(XmlAnyElementAttribute[], Int32) CopyTo(XmlAnyElementAttribute[], Int32)

コピー先配列の指定されたインデックスを開始位置として、コレクション全体を、XmlElementAttribute オブジェクトの互換性がある 1 次元配列にコピーします。Copies the entire collection to a compatible one-dimensional array of XmlElementAttribute objects, starting at the specified index of the target array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
IndexOf(XmlAnyElementAttribute) IndexOf(XmlAnyElementAttribute) IndexOf(XmlAnyElementAttribute) IndexOf(XmlAnyElementAttribute)

指定した XmlAnyElementAttribute のインデックスを取得します。Gets the index of the specified XmlAnyElementAttribute.

Insert(Int32, XmlAnyElementAttribute) Insert(Int32, XmlAnyElementAttribute) Insert(Int32, XmlAnyElementAttribute) Insert(Int32, XmlAnyElementAttribute)

XmlAnyElementAttribute をコレクション内の指定のインデックス位置に挿入します。Inserts an XmlAnyElementAttribute into the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnClear() OnClear() OnClear() OnClear()

CollectionBase インスタンスの内容を消去しているときに、追加のカスタム プロセスを実行します。Performs additional custom processes when clearing the contents of the CollectionBase instance.

(Inherited from CollectionBase)
OnClearComplete() OnClearComplete() OnClearComplete() OnClearComplete()

CollectionBase インスタンスの内容を消去した後に、追加のカスタム プロセスを実行します。Performs additional custom processes after clearing the contents of the CollectionBase instance.

(Inherited from CollectionBase)
OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object)

CollectionBase インスタンスに新しい要素を挿入する前に、追加のカスタム プロセスを実行します。Performs additional custom processes before inserting a new element into the CollectionBase instance.

(Inherited from CollectionBase)
OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object)

CollectionBase インスタンスに新しい要素を挿入した後に、追加のカスタム プロセスを実行します。Performs additional custom processes after inserting a new element into the CollectionBase instance.

(Inherited from CollectionBase)
OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object)

CollectionBase インスタンスから要素を削除するときに、追加のカスタム プロセスを実行します。Performs additional custom processes when removing an element from the CollectionBase instance.

(Inherited from CollectionBase)
OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object)

CollectionBase インスタンスから要素を削除した後に、追加のカスタム プロセスを実行します。Performs additional custom processes after removing an element from the CollectionBase instance.

(Inherited from CollectionBase)
OnSet(Int32, Object, Object) OnSet(Int32, Object, Object) OnSet(Int32, Object, Object) OnSet(Int32, Object, Object)

CollectionBase インスタンスに値を設定する前に、追加のカスタム プロセスを実行します。Performs additional custom processes before setting a value in the CollectionBase instance.

(Inherited from CollectionBase)
OnSetComplete(Int32, Object, Object) OnSetComplete(Int32, Object, Object) OnSetComplete(Int32, Object, Object) OnSetComplete(Int32, Object, Object)

CollectionBase インスタンスに値を設定した後に、追加のカスタム プロセスを実行します。Performs additional custom processes after setting a value in the CollectionBase instance.

(Inherited from CollectionBase)
OnValidate(Object) OnValidate(Object) OnValidate(Object) OnValidate(Object)

値を検証するときに、追加のカスタム プロセスを実行します。Performs additional custom processes when validating a value.

(Inherited from CollectionBase)
Remove(XmlAnyElementAttribute) Remove(XmlAnyElementAttribute) Remove(XmlAnyElementAttribute) Remove(XmlAnyElementAttribute)

指定された XmlAnyElementAttribute をコレクションから削除します。Removes the specified XmlAnyElementAttribute from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

明示的なインターフェイスの実装

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot
IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)
IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)
IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)
IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)
IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize
IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly
IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]
IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

拡張メソッド

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象