DataContractSerializer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたデータ コントラクトを使用して、型のインスタンスを XML ストリームまたはドキュメントにシリアル化および逆シリアル化します。 このクラスは継承できません。
public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer- 継承
注釈
この API の詳細については、「 DataContractSerializer の補足 API 解説」を参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| DataContractSerializer(Type, DataContractSerializerSettings) |
指定した型と設定のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドでは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化するグラフ項目の最大数、予期しないデータを無視するパラメーター、グラフ内のオブジェクト参照データを保持するために非標準 XML コンストラクトを使用するかどうか、カスタム シリアル化のサロゲート、および実行時に |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化するグラフ項目の最大数、予期しないデータを無視するパラメーター、グラフ内のオブジェクト参照データを保持するために標準以外の XML コンストラクトを使用するかどうか、およびカスタム シリアル化のサロゲートも指定します。 |
| DataContractSerializer(Type, IEnumerable<Type>) |
指定した型のオブジェクトと、オブジェクト グラフに存在する既知の型のコレクションをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化するグラフ項目の最大数、予期しないデータを無視するパラメーター、グラフ内のオブジェクト参照データを保持するために非標準 XML コンストラクトを使用するかどうか、カスタム シリアル化のサロゲート、コンテンツを含む XML 要素および名前空間を指定します。 および実行時に |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 このメソッドでは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化するグラフ 項目の最大数、予期しないデータを無視するパラメーター、グラフ内のオブジェクト参照データを保持するために非標準 XML コンストラクトを使用するかどうか、カスタム シリアル化のサロゲート、およびコンテンツを含む XML 要素と名前空間も指定します。 |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 このメソッドでは、ルート XML 要素と名前空間も 2 つの文字列パラメーターに指定し、オブジェクト グラフに存在する可能性がある既知の型の一覧も指定します。 |
| DataContractSerializer(Type, String, String) |
指定した XML ルート要素と名前空間を使用して、指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化するグラフ項目の最大数、予期しないデータを無視するパラメーター、グラフ内のオブジェクト参照データを保持するために非標準 XML コンストラクトを使用するかどうか、カスタム シリアル化のサロゲート、コンテンツを含む XML 要素と名前空間を指定する XmlDictionaryString のパラメーターを指定します。 および実行時に |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 このメソッドでは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化するグラフ項目の最大数、予期しないデータを無視するパラメーター、グラフ内のオブジェクト参照データを保持するために非標準 XML コンストラクトを使用するかどうか、カスタム シリアル化のサロゲート、およびコンテンツを含む XML 要素と名前空間を指定する XmlDictionaryString のパラメーターも指定します。 |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドは、2 つの XmlDictionaryString パラメーターのルート XML 要素と名前空間、およびオブジェクト グラフに存在する可能性がある既知の型の一覧も指定します。 |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
XmlDictionaryString型のパラメーターで指定された XML ルート要素と名前空間を使用して、指定した型のオブジェクトをシリアル化または逆シリアル化するために、DataContractSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractSerializer(Type) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractSerializer クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| DataContractResolver |
|
| DataContractSurrogate |
シリアル化または逆シリアル化プロセスを拡張できるサロゲート型を取得します。 |
| IgnoreExtensionDataObject |
クラスがシリアル化または逆シリアル化されるときに、クラスの拡張機能によって提供されるデータを無視するかどうかを指定する値を取得します。 |
| KnownTypes |
DataContractSerializerのこのインスタンスを使用してシリアル化されたオブジェクト グラフに存在する可能性がある型のコレクションを取得します。 |
| MaxItemsInObjectGraph |
シリアル化または逆シリアル化するオブジェクト グラフ内の項目の最大数を取得します。 |
| PreserveObjectReferences |
非標準 XML コンストラクトを使用してオブジェクト参照データを保持するかどうかを指定する値を取得します。 |
| SerializeReadOnlyTypes |
読み取り専用型をシリアル化するかどうかを指定する値を取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IsStartObject(XmlDictionaryReader) |
逆シリアル化できるオブジェクトに XmlDictionaryReader が配置されているかどうかを判断します。 |
| IsStartObject(XmlReader) |
逆シリアル化できるオブジェクトに XmlReader が配置されているかどうかを判断します。 |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| ReadObject(Stream) |
Streamを使用して XML ストリームまたはドキュメントを読み取り、逆シリアル化されたオブジェクトを返します。 (継承元 XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader, Boolean, DataContractResolver) |
XML ドキュメントまたはドキュメント ストリームを読み取り、逆シリアル化されたオブジェクトを返します。 このメソッドには、オブジェクト名が検証されるかどうかを指定するパラメーターと、実行時に宣言 |
| ReadObject(XmlDictionaryReader, Boolean) |
XmlDictionaryReaderを使用して XML ストリームを読み取り、逆シリアル化されたオブジェクトを返します。また、値を読み取る前に、オブジェクト名を検証するためのチェックが行われるかどうかを指定します。 |
| ReadObject(XmlDictionaryReader) |
XmlDictionaryReaderを使用して XML ドキュメントまたはストリームを読み取り、逆シリアル化されたオブジェクトを返します。 (継承元 XmlObjectSerializer) |
| ReadObject(XmlReader, Boolean) |
XmlReaderを使用して XML ストリームを読み取り、逆シリアル化されたオブジェクトを返します。また、値を読み取る前に、オブジェクト名を検証するためのチェックが行われるかどうかを指定します。 |
| ReadObject(XmlReader) |
XmlReaderを使用して XML ストリームを読み取り、逆シリアル化されたオブジェクトを返します。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
| WriteEndObject(XmlDictionaryWriter) |
XmlDictionaryWriterを使用して終了 XML 要素を書き込みます。 |
| WriteEndObject(XmlWriter) |
XmlWriterを使用して終了 XML 要素を書き込みます。 |
| WriteObject(Stream, Object) |
指定した Streamを使用して、オブジェクトの完全なコンテンツ (開始、コンテンツ、終了) を XML ドキュメントまたはストリームに書き込みます。 (継承元 XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object, DataContractResolver) |
指定した XmlDictionaryWriter を使用して、すべてのオブジェクト データ (開始 XML 要素、コンテンツ、および外側の要素) を XML ドキュメントまたはストリームに書き込みます。 このメソッドには、実行時に |
| WriteObject(XmlDictionaryWriter, Object) |
指定した XmlDictionaryWriterを使用して、オブジェクトの完全なコンテンツ (開始、コンテンツ、終了) を XML ドキュメントまたはストリームに書き込みます。 (継承元 XmlObjectSerializer) |
| WriteObject(XmlWriter, Object) |
すべてのオブジェクト データ (開始 XML 要素、コンテンツ、および終了要素) を、 XmlWriterを使用して XML ドキュメントまたはストリームに書き込みます。 |
| WriteObjectContent(XmlDictionaryWriter, Object) |
XmlDictionaryWriterを使用して XML コンテンツを書き込みます。 |
| WriteObjectContent(XmlWriter, Object) |
XmlWriterを使用して XML コンテンツを書き込みます。 |
| WriteStartObject(XmlDictionaryWriter, Object) |
XmlDictionaryWriterを使用して開始 XML 要素を書き込みます。 |
| WriteStartObject(XmlWriter, Object) |
XmlWriterを使用して開始 XML 要素を書き込みます。 |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetSerializationSurrogateProvider(DataContractSerializer) |
このシリアライザーのサロゲート シリアル化プロバイダーを返します。 |
| SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider) |
この DataContractSerializerのサロゲート シリアル化プロバイダーを指定します。 |
適用対象
スレッド セーフ
このクラスのインスタンスは、インスタンスが IDataContractSurrogate または DataContractResolverの実装で使用される場合を除き、スレッド セーフです。