DataContractJsonSerializer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクトを JavaScript Object Notation (JSON) にシリアル化し、JSON データをオブジェクトに逆シリアル化します。 このクラスは継承できません。
public ref class DataContractJsonSerializer sealedpublic ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractJsonSerializerpublic sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractJsonSerializer = classtype DataContractJsonSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractJsonSerializerPublic NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer- 継承
-
DataContractJsonSerializer
- 継承
注釈
JSON へのシリアル化と JSON からの逆シリアル化を伴うほとんどのシナリオでは、 System.Text.Json 名前空間の API をお勧めします。
シナリオで DataContractJsonSerializer クラスが必要な場合は、それを使用して型のインスタンスを JSON ドキュメントにシリアル化し、JSON ドキュメントを型のインスタンスに逆シリアル化できます。 たとえば、名前や住所などの重要なデータを含むプロパティを使用して、 Person という名前の型を作成できます。 その後、 Person クラスのインスタンスを作成して操作し、そのプロパティ値をすべて JSON ドキュメントに書き込んで、後で取得できます。 この JSON ドキュメントは、後で、同等のデータ コントラクトを使用して、 Person クラスまたは別のクラスに逆シリアル化できます。
サーバーでの送信応答のシリアル化中にエラーが発生した場合、または応答操作が何らかの理由で例外をスローした場合、エラーとしてクライアントに返されない可能性があります。
コンストラクター
| 名前 | 説明 |
|---|---|
| DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) |
指定した型とシリアライザー設定のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドでは、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化または逆シリアル化するグラフ項目の最大数、予期しないデータを無視するか型情報を出力するか、カスタム シリアル化のサロゲートを指定します。 |
| DataContractJsonSerializer(Type, IEnumerable<Type>) |
オブジェクト グラフに存在する既知の型のコレクションを使用して、指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドでは、XML 要素のルート名、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化または逆シリアル化するグラフ項目の最大数、予期しないデータを無視するか型情報を出力するか、カスタム シリアル化のサロゲートを指定します。 |
| DataContractJsonSerializer(Type, String, IEnumerable<Type>) |
パラメーターで指定された XML ルート要素を使用して、オブジェクト グラフに存在する既知の型のコレクションを使用して、指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractJsonSerializer(Type, String) |
パラメーターで指定された XML ルート要素を使用して、指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 また、このメソッドでは、XML 要素のルート名、オブジェクト グラフに存在する可能性がある既知の型の一覧、シリアル化または逆シリアル化するグラフ項目の最大数、予期しないデータを無視するか型情報を出力するか、カスタム シリアル化のサロゲートを指定します。 |
| DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) |
DataContractJsonSerializer クラスの新しいインスタンスを初期化し、XmlDictionaryString型のパラメーターで指定された XML ルート要素を使用して、オブジェクト グラフに存在する既知の型のコレクションを使用して、指定した型のオブジェクトをシリアル化または逆シリアル化します。 |
| DataContractJsonSerializer(Type, XmlDictionaryString) |
XmlDictionaryString型のパラメーターで指定された XML ルート要素を使用して、指定した型のオブジェクトをシリアル化または逆シリアル化するために、DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 |
| DataContractJsonSerializer(Type) |
指定した型のオブジェクトをシリアル化または逆シリアル化するために、 DataContractJsonSerializer クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| DataContractSurrogate |
特定の IDataContractSurrogate インスタンスに対して現在アクティブなサロゲート型を取得します。 サロゲートは、シリアル化または逆シリアル化プロセスを拡張できます。 |
| DateTimeFormat |
オブジェクト グラフの日付と時刻型の項目の形式を取得します。 |
| EmitTypeInformation |
型情報を出力するデータ コントラクト JSON シリアライザー設定を取得または設定します。 |
| IgnoreExtensionDataObject |
逆シリアル化時に不明なデータを無視するかどうか、およびシリアル化時に IExtensibleDataObject インターフェイスを無視するかどうかを指定する値を取得します。 |
| KnownTypes |
DataContractJsonSerializerのこのインスタンスを使用してシリアル化されたオブジェクト グラフに存在する可能性がある型のコレクションを取得します。 |
| MaxItemsInObjectGraph |
シリアライザーが 1 回の読み取りまたは書き込み呼び出しでシリアル化または逆シリアル化するオブジェクト グラフ内の項目の最大数を取得します。 |
| SerializeReadOnlyTypes |
読み取り専用型をシリアル化するかどうかを指定する値を取得または設定します。 |
| UseSimpleDictionaryFormat |
単純なディクショナリ形式を使用するかどうかを指定する値を取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IsStartObject(XmlDictionaryReader) |
シリアライザーが逆シリアル化できるオブジェクトを表す XML 要素の上に XmlDictionaryReader を配置するかどうかを指定する値を取得します。 |
| IsStartObject(XmlReader) |
逆シリアル化できるオブジェクトに XmlReader が配置されているかどうかを判断します。 |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| ReadObject(Stream) |
JSON (JavaScript Object Notation) 形式でドキュメント ストリームを読み取り、逆シリアル化されたオブジェクトを返します。 |
| ReadObject(XmlDictionaryReader, Boolean) |
JSON からマップされた XML ドキュメントを XmlDictionaryReader と共に読み取り、逆シリアル化されたオブジェクトを返します。逆シリアル化を試みる前に、シリアライザーが適切な要素に配置されていることを確認する必要があるかどうかを指定することもできます。 |
| ReadObject(XmlDictionaryReader) |
JSON (JavaScript Object Notation) からマップされた XML ドキュメントを XmlDictionaryReader と共に読み取り、逆シリアル化されたオブジェクトを返します。 |
| ReadObject(XmlReader, Boolean) |
JSON からマップされた XML ドキュメントを XmlReader で読み取り、逆シリアル化されたオブジェクトを返します。逆シリアル化を試みる前に、シリアライザーが適切な要素に配置されていることを確認する必要があるかどうかを指定することもできます。 |
| ReadObject(XmlReader) |
JSON (JavaScript Object Notation) からマップされた XML ドキュメントを XmlReader と共に読み取り、逆シリアル化されたオブジェクトを返します。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
| WriteEndObject(XmlDictionaryWriter) |
javaScript Object Notation (JSON) にマップできる XmlDictionaryWriterを使用して、終了 XML 要素を XML ドキュメントに書き込みます。 |
| WriteEndObject(XmlWriter) |
javaScript Object Notation (JSON) にマップできる XmlWriterを使用して、終了 XML 要素を XML ドキュメントに書き込みます。 |
| WriteObject(Stream, Object) |
指定したオブジェクトを JavaScript Object Notation (JSON) データにシリアル化し、結果の JSON をストリームに書き込みます。 |
| WriteObject(XmlDictionaryWriter, Object) |
JavaScript Object Notation (JSON) にマップできる XML にオブジェクトをシリアル化します。 開始 XML 要素、コンテンツ、終了要素を含むすべてのオブジェクト データを、 XmlDictionaryWriterで書き込みます。 |
| WriteObject(XmlWriter, Object) |
JavaScript Object Notation (JSON) にマップできる XML にオブジェクトをシリアル化します。 開始 XML 要素、コンテンツ、終了要素を含むすべてのオブジェクト データを、 XmlWriterで書き込みます。 |
| WriteObjectContent(XmlDictionaryWriter, Object) |
XmlDictionaryWriterを使用して JavaScript Object Notation (JSON) にマップできる XML コンテンツを書き込みます。 |
| WriteObjectContent(XmlWriter, Object) |
XmlWriterを使用して JavaScript Object Notation (JSON) にマップできる XML コンテンツを書き込みます。 |
| WriteStartObject(XmlDictionaryWriter, Object) |
XmlDictionaryWriterを使用して JavaScript Object Notation (JSON) にマップできるオブジェクトを XML にシリアル化するための開始 XML 要素を書き込みます。 |
| WriteStartObject(XmlWriter, Object) |
XmlWriterを使用して JavaScript Object Notation (JSON) にマップできるオブジェクトを XML にシリアル化するための開始 XML 要素を書き込みます。 |