DataContractJsonSerializer DataContractJsonSerializer DataContractJsonSerializer DataContractJsonSerializer Class

定義

オブジェクトを JSON (JavaScript Object Notation) にシリアル化し、JSON データをオブジェクトに逆シリアル化します。Serializes objects to the JavaScript Object Notation (JSON) and deserializes JSON data to objects. このクラスは継承できません。This class cannot be inherited.

public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractJsonSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer
継承
DataContractJsonSerializerDataContractJsonSerializerDataContractJsonSerializerDataContractJsonSerializer

注釈

DataContractJsonSerializer クラスを使用して、型のインスタンスを JSON ドキュメントにシリアル化したり、JSON ドキュメントを型のインスタンスに逆シリアル化したりします。Use the DataContractJsonSerializer class to serialize instances of a type into a JSON document and to deserialize a JSON document into an instance of a type. たとえば、名前や住所などの必須データを含むプロパティを持つ Person という名前の型を作成できます。For example, you can create a type named Person with properties that contain essential data, such as a name and address. その後、Person クラスのインスタンスを作成して操作することで、すべてのプロパティ値を JSON ドキュメントに書き込み、後で取得することができます。You can then create and manipulate an instance of the Person class and write all of its property values in a JSON document for later retrieval. この JSON ドキュメントは、後で、Person クラスまたは同等のデータ コントラクトを持つクラスに逆シリアル化できます。This JSON document can later be deserialized into the Person class or another class with an equivalent data contract.

サーバー上で送信応答のシリアル化中にエラーが発生した場合、または応答操作がなんらかの理由で例外をスローした場合、エラーにより応答がクライアントに戻らないことがあります。If an error occurs during the serialization of an outgoing reply on the server or the reply operation throws an exception for some other reason, it may not get returned to the client as a fault.

コンストラクター

DataContractJsonSerializer(Type) DataContractJsonSerializer(Type) DataContractJsonSerializer(Type) DataContractJsonSerializer(Type)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトをシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

指定した型とシリアライザー設定のオブジェクトをシリアル化または逆シリアル化する DataContractJsonSerializer クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type and serializer settings.

DataContractJsonSerializer(Type, IEnumerable<Type>) DataContractJsonSerializer(Type, IEnumerable<Type>) DataContractJsonSerializer(Type, IEnumerable<Type>) DataContractJsonSerializer(Type, IEnumerable<Type>)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトと、オブジェクト グラフ内に存在可能な既知の型のコレクションをシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type, with a collection of known types that may be present in the object graph.

DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトをシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. このメソッドは、さらに、オブジェクト グラフ内に存在可能な既知の型のリスト、シリアル化または逆シリアル化するグラフ項目の最大数、予期しないデータを無視するかどうかまたは型情報を出力するかどうか、およびカスタム シリアル化のためのサロゲートを指定します。This method also specifies a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

DataContractJsonSerializer(Type, String) DataContractJsonSerializer(Type, String) DataContractJsonSerializer(Type, String) DataContractJsonSerializer(Type, String)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトを、パラメーターで指定した XML ルート要素を使用してシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter.

DataContractJsonSerializer(Type, String, IEnumerable<Type>) DataContractJsonSerializer(Type, String, IEnumerable<Type>) DataContractJsonSerializer(Type, String, IEnumerable<Type>) DataContractJsonSerializer(Type, String, IEnumerable<Type>)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトと、オブジェクト グラフ内に存在可能な既知の型のコレクションを、パラメーターで指定した XML ルート要素を使用してシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter, with a collection of known types that may be present in the object graph.

DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトをシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. このメソッドは、さらに、XML 要素のルート名、オブジェクト グラフ内に存在可能な既知の型のリスト、シリアル化または逆シリアル化するグラフ項目の最大数、予期しないデータを無視するかどうかまたは型情報を出力するかどうか、およびカスタム シリアル化のためのサロゲートを指定します。This method also specifies the root name of the XML element, a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

DataContractJsonSerializer(Type, XmlDictionaryString) DataContractJsonSerializer(Type, XmlDictionaryString) DataContractJsonSerializer(Type, XmlDictionaryString) DataContractJsonSerializer(Type, XmlDictionaryString)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトを、型 XmlDictionaryString のパラメーターで指定した XML ルート要素を使用してシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter of type XmlDictionaryString.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトと、オブジェクト グラフ内に存在可能な既知の型のコレクションを、型 XmlDictionaryString のパラメーターで指定した XML ルート要素を使用してシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter of type XmlDictionaryString, with a collection of known types that may be present in the object graph.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

DataContractJsonSerializer クラスの新しいインスタンスを初期化し、指定した型のオブジェクトをシリアル化または逆シリアル化します。Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. このメソッドは、さらに、XML 要素のルート名、オブジェクト グラフ内に存在可能な既知の型のリスト、シリアル化または逆シリアル化するグラフ項目の最大数、予期しないデータを無視するかどうかまたは型情報を出力するかどうか、およびカスタム シリアル化のためのサロゲートを指定します。This method also specifies the root name of the XML element, a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

プロパティ

DataContractSurrogate DataContractSurrogate DataContractSurrogate DataContractSurrogate

指定した IDataContractSurrogate インスタンスで現在アクティブなサロゲート型を取得します。Gets a surrogate type that is currently active for a given IDataContractSurrogate instance. サロゲートは、シリアル化または逆シリアル化プロセスを拡張できます。Surrogates can extend the serialization or deserialization process.

DateTimeFormat DateTimeFormat DateTimeFormat DateTimeFormat

オブジェクト グラフの日付型および時刻型の項目の書式を取得します。Gets the format of the date and time type items in object graph.

EmitTypeInformation EmitTypeInformation EmitTypeInformation EmitTypeInformation

型情報を出力するデータ コントラクトの JSON シリアライザーの設定を取得または設定します。Gets or sets the data contract JSON serializer settings to emit type information.

IgnoreExtensionDataObject IgnoreExtensionDataObject IgnoreExtensionDataObject IgnoreExtensionDataObject

逆シリアル化時に未知のデータを無視するかどうか、およびシリアル化時に IExtensibleDataObject インターフェイスを無視するかどうかを指定する値を取得します。Gets a value that specifies whether unknown data is ignored on deserialization and whether the IExtensibleDataObject interface is ignored on serialization.

KnownTypes KnownTypes KnownTypes KnownTypes

DataContractJsonSerializer のこのインスタンスを使用してシリアル化されるオブジェクト グラフ内に存在可能な型のコレクションを取得します。Gets a collection of types that may be present in the object graph serialized using this instance of the DataContractJsonSerializer.

MaxItemsInObjectGraph MaxItemsInObjectGraph MaxItemsInObjectGraph MaxItemsInObjectGraph

シリアライザーが 1 回の読み取りまたは書き込みの呼び出しでシリアル化または逆シリアル化するオブジェクト グラフ内の項目の最大数を取得します。Gets the maximum number of items in an object graph that the serializer serializes or deserializes in one read or write call.

SerializeReadOnlyTypes SerializeReadOnlyTypes SerializeReadOnlyTypes SerializeReadOnlyTypes

読み取り専用の型をシリアル化するかどうかを指定する値を取得または設定します。Gets or sets a value that specifies whether to serialize read only types.

UseSimpleDictionaryFormat UseSimpleDictionaryFormat UseSimpleDictionaryFormat UseSimpleDictionaryFormat

簡単なディクショナリ形式を使用するかどうかを指定する値を取得します。Gets a value that specifies whether to use a simple dictionary format.

メソッド

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

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

(Inherited from Object)
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)
IsStartObject(XmlDictionaryReader) IsStartObject(XmlDictionaryReader) IsStartObject(XmlDictionaryReader) IsStartObject(XmlDictionaryReader)

シリアライザーが逆シリアル化できるオブジェクトを表す XML 要素に XmlDictionaryReader が配置されているかどうかを指定する値を取得します。Gets a value that specifies whether the XmlDictionaryReader is positioned over an XML element that represents an object the serializer can deserialize from.

IsStartObject(XmlReader) IsStartObject(XmlReader) IsStartObject(XmlReader) IsStartObject(XmlReader)

逆シリアル化できるオブジェクトに XmlReader が配置されているかどうかを決定します。Determines whether the XmlReader is positioned on an object that can be deserialized.

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

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

(Inherited from Object)
ReadObject(Stream) ReadObject(Stream) ReadObject(Stream) ReadObject(Stream)

ドキュメント ストリームを JSON (JavaScript Object Notation) 形式で読み取り、逆シリアル化されたオブジェクトを返します。Reads a document stream in the JSON (JavaScript Object Notation) format and returns the deserialized object.

ReadObject(XmlDictionaryReader) ReadObject(XmlDictionaryReader) ReadObject(XmlDictionaryReader) ReadObject(XmlDictionaryReader)

XmlDictionaryReader を使用して、JSON (JavaScript Object Notation) からマップされた XML ドキュメントを読み取り、逆シリアル化されたオブジェクトを返します。Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlDictionaryReader and returns the deserialized object.

ReadObject(XmlDictionaryReader, Boolean) ReadObject(XmlDictionaryReader, Boolean) ReadObject(XmlDictionaryReader, Boolean) ReadObject(XmlDictionaryReader, Boolean)

XmlDictionaryReader を使用して、JSON からマップされた XML ドキュメントを読み取り、逆シリアル化されたオブジェクトを返します。さらに、逆シリアル化を試みる前に、シリアライザーが適切な要素に配置されていることを確認する必要があるかどうかを指定できます。Reads the XML document mapped from JSON with an XmlDictionaryReader and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.

ReadObject(XmlReader) ReadObject(XmlReader) ReadObject(XmlReader) ReadObject(XmlReader)

XmlReader を使用して、JSON (JavaScript Object Notation) からマップされた XML ドキュメントを読み取り、逆シリアル化されたオブジェクトを返します。Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlReader and returns the deserialized object.

ReadObject(XmlReader, Boolean) ReadObject(XmlReader, Boolean) ReadObject(XmlReader, Boolean) ReadObject(XmlReader, Boolean)

XmlReader を使用して、JSON からマップされた XML ドキュメントを読み取り、逆シリアル化されたオブジェクトを返します。さらに、逆シリアル化を試みる前に、シリアライザーが適切な要素に配置されていることを確認する必要があるかどうかを指定できます。Reads an XML document mapped from JSON with an XmlReader and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)
WriteEndObject(XmlDictionaryWriter) WriteEndObject(XmlDictionaryWriter) WriteEndObject(XmlDictionaryWriter) WriteEndObject(XmlDictionaryWriter)

XML の終了要素を、XmlDictionaryWriter を使用して、JSON (JavaScript Object Notation) にマップ可能な XML ドキュメントに書き込みます。Writes the closing XML element to an XML document, using an XmlDictionaryWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteEndObject(XmlWriter) WriteEndObject(XmlWriter) WriteEndObject(XmlWriter) WriteEndObject(XmlWriter)

XML の終了要素を、XmlWriter を使用して、JSON (JavaScript Object Notation) にマップ可能な XML ドキュメントに書き込みます。Writes the closing XML element to an XML document, using an XmlWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteObject(Stream, Object) WriteObject(Stream, Object) WriteObject(Stream, Object) WriteObject(Stream, Object)

指定したオブジェクトを JSON (JavaScript Object Notation) データにシリアル化し、生成された JSON をストリームに書き込みます。Serializes a specified object to JavaScript Object Notation (JSON) data and writes the resulting JSON to a stream.

WriteObject(XmlDictionaryWriter, Object) WriteObject(XmlDictionaryWriter, Object) WriteObject(XmlDictionaryWriter, Object) WriteObject(XmlDictionaryWriter, Object)

オブジェクトを JSON (JavaScript Object Notation) にマップ可能な XML にシリアル化します。Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). XmlDictionaryWriter を使用して、XML の開始要素、コンテンツ、終了要素を含む、すべてのオブジェクト データを書き込みます。Writes all the object data, including the starting XML element, content, and closing element, with an XmlDictionaryWriter.

WriteObject(XmlWriter, Object) WriteObject(XmlWriter, Object) WriteObject(XmlWriter, Object) WriteObject(XmlWriter, Object)

オブジェクトを JSON (JavaScript Object Notation) にマップ可能な XML にシリアル化します。Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). XmlWriter を使用して、XML の開始要素、コンテンツ、終了要素を含む、すべてのオブジェクト データを書き込みます。Writes all the object data, including the starting XML element, content, and closing element, with an XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object) WriteObjectContent(XmlDictionaryWriter, Object) WriteObjectContent(XmlDictionaryWriter, Object) WriteObjectContent(XmlDictionaryWriter, Object)

XmlDictionaryWriter を使用して、JSON (JavaScript Object Notation) にマップ可能な XML コンテンツを書き込みます。Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object) WriteObjectContent(XmlWriter, Object) WriteObjectContent(XmlWriter, Object) WriteObjectContent(XmlWriter, Object)

XmlWriter を使用して、JSON (JavaScript Object Notation) にマップ可能な XML コンテンツを書き込みます。Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object) WriteStartObject(XmlDictionaryWriter, Object) WriteStartObject(XmlDictionaryWriter, Object) WriteStartObject(XmlDictionaryWriter, Object)

XmlDictionaryWriter を使用して、XML の開始要素を書き込み、オブジェクトを、JSON (JavaScript Object Notation) にマップ可能な XML にシリアル化します。Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object) WriteStartObject(XmlWriter, Object) WriteStartObject(XmlWriter, Object) WriteStartObject(XmlWriter, Object)

XmlWriter を使用して、XML の開始要素を書き込み、オブジェクトを、JSON (JavaScript Object Notation) にマップ可能な XML にシリアル化します。Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

適用対象