System.Xml.Serialization 名前空間

System.Xml.Serialization 名前空間には、オブジェクトを XML 形式のドキュメントまたはストリームにシリアル化するために使用されるクラスが含まれています。

この名前空間の中核となるクラスは XmlSerializer クラスです。このクラスを使用するには、 XmlSerializer コンストラクタを使用し、シリアル化するオブジェクトの型を指定して、クラスのインスタンスを作成します。 XmlSerializer が作成されたら、シリアル化するオブジェクトのインスタンスを作成します。 Stream 、 TextWriter 、 XmlWriter など、ドキュメントまたはストリームにファイルを書き込むためのオブジェクトも作成する必要があります。その後、 Serialize メソッドを呼び出して、オブジェクトを XML ドキュメントに変換できます。

XML ドキュメントからオブジェクトを逆シリアル化するには、ドキュメントまたはストリームからの読み取りを行う適切なオブジェクト (Stream 、 TextWriter 、または XmlWriter) を作成します。結果として得られたオブジェクトを元のオブジェクト (シリアル化されたオブジェクト) の型にキャストしているときに、 Deserialize メソッドを呼び出します。

さらにシリアル化を制御できるように、 System.Xml.Serialization 名前空間には、クラスのメンバに適用できる Attribute クラスが含まれています。たとえば、クラスに XML 要素としてシリアル化されるメンバが含まれている場合は、そのメンバに XmlElementAttribute 属性を適用できます。この属性を適用するときには、 ElementName プロパティを使用して、実際の XML 要素の名前などの詳細を指定できます。すべての属性の完全な一覧については、 XmlSerializer クラスの概要を参照してください。

名前空間の階層構造

クラス

クラス	説明
SoapAttributeAttribute	XmlSerializer がクラス メンバをエンコード済みの SOAP 属性としてシリアル化することを指定します。
SoapAttributeOverrides	XmlSerializer を使用してオブジェクトをエンコード済みの SOAP としてシリアル化または逆シリアル化するときに、プロパティ、フィールド、クラスの各属性をオーバーライドできるようにします。
SoapAttributes	XmlSerializer が SOAP メソッドをシリアル化および逆シリアル化する方法を制御する属性オブジェクトのコレクションを表します。
SoapElementAttribute	XmlSerializer がパブリック メンバの値をエンコード済みの SOAP XML 要素としてシリアル化することを指定します。
SoapEnumAttribute	XmlSerializer が列挙体メンバをシリアル化する方法を制御します。
SoapIgnoreAttribute	XmlSerializer に対して、パブリック フィールドまたはパブリックな読み書き可能プロパティの値をシリアル化しないように指示します。
SoapIncludeAttribute	XmlSerializer がオブジェクトをエンコード済みの SOAP XML としてシリアル化または逆シリアル化するときに、型を認識できるようにします。
SoapTypeAttribute	SOAP エンコード済みの XML としてクラス インスタンスがシリアル化されるときに、 XmlSerializer によって生成されるスキーマを制御します。
UnreferencedObjectEventArgs	エンコード済みの SOAP XML ストリームで逆シリアル化時に見つかった、既知ではあっても未参照のオブジェクトに対してデータを提供します。
XmlAnyAttributeAttribute	メンバ (XmlAttribute オブジェクトの配列を返すフィールド) に任意の XML 属性を含めることができるように指定します。
XmlAnyElementAttribute	メンバ (XmlElement オブジェクトまたは XmlNode オブジェクトの配列を返すフィールド) に、シリアル化または逆シリアル化対象のオブジェクト内に対応するメンバがない任意の XML 要素を表すオブジェクトを含めることができるように指定します。
XmlAnyElementAttributes	XmlAnyElementAttribute オブジェクトのコレクションを表します。
XmlArrayAttribute	XmlSerializer が特定のクラス メンバを XML 要素の配列としてシリアル化することを指定します。
XmlArrayItemAttribute	XmlSerializer がシリアル化された配列で配置できる派生型を指定します。
XmlArrayItemAttributes	XmlArrayItemAttribute オブジェクトのコレクションを表します。
XmlAttributeAttribute	XmlSerializer がクラス メンバを XML 属性としてシリアル化することを指定します。
XmlAttributeEventArgs	UnknownAttribute イベントのデータを提供します。
XmlAttributeOverrides	オブジェクトをシリアル化または逆シリアル化するために XmlSerializer を使用するときに、プロパティ、フィールド、クラスの各属性をユーザーがオーバーライドできるようにします。
XmlAttributes	XmlSerializer がオブジェクトをシリアル化および逆シリアル化する方法を制御する属性オブジェクトのコレクションを示します。
XmlChoiceIdentifierAttribute	列挙体を使用して、メンバを明確に区別できるようにすることを指定します。
XmlElementAttribute	パブリック フィールドやパブリック プロパティを保持するオブジェクトを XmlSerializer がシリアル化または逆シリアル化するときに、それらのフィールドやプロパティが XML 要素を表すかどうかを示します。
XmlElementAttributes	XmlSerializer がクラスをシリアル化する既定の方法をオーバーライドするために使用する、 XmlElementAttribute のコレクションを表します。
XmlElementEventArgs	UnknownElement イベントのデータを提供します。
XmlEnumAttribute	XmlSerializer が列挙体メンバをシリアル化する方法を制御します。
XmlIgnoreAttribute	XmlSerializer の Serialize メソッドに対して、パブリック フィールドまたはパブリックな読み書き可能プロパティの値をシリアル化しないように指示します。
XmlIncludeAttribute	XmlSerializer がオブジェクトをシリアル化または逆シリアル化するときに、型を認識できるようにします。
XmlNamespaceDeclarationsAttribute	対象となるプロパティ、パラメータ、戻り値、またはクラス メンバに、XML ドキュメント内で使用する、名前空間に関連付けられたプリフィックスを含めることを指定します。
XmlNodeEventArgs	UnknownNode イベントのデータを提供します。
XmlRootAttribute	属性ターゲットを XML ルート要素として XML シリアル化する方法を制御します。
XmlSerializer	オブジェクトから XML ドキュメントへのシリアル化および XML ドキュメントからオブジェクトへの逆シリアル化を行います。 XmlSerializer により、オブジェクトを XML にエンコードする方法を制御できます。
XmlSerializerNamespaces	XmlSerializer が XML ドキュメント インスタンスで限定名を生成するために使用する XML 名前空間とプリフィックスが格納されています。
XmlTextAttribute	XmlSerializer が、クラスをシリアル化化または逆シリアル化するときに、そのクラスに含まれる特定のメンバを XML テキストとして処理することを指定します。
XmlTypeAttribute	この属性が適用された対象が XmlSerializer によってシリアル化されるときに生成される XML スキーマを制御します。
XmlTypeMapping	1 つの型から別の型への割り当てを格納します。

デリゲート

デリゲート	説明
UnreferencedObjectEventHandler	XmlSerializer の UnreferencedObject イベントを処理するメソッドを表します。
XmlAttributeEventHandler	UnknownAttribute イベントを処理するメソッドを表します。
XmlElementEventHandler	XmlSerializer の UnknownElement イベントを処理するメソッドを表します。
XmlNodeEventHandler	XmlSerializer の UnknownNode イベントを処理するメソッドを表します。

参照

.NET Framework クラス ライブラリ