JsonSerializer.Deserialize メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
Deserialize(Stream, JsonTypeInfo)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、 jsonTypeInfoで指定されたインスタンスに読み取ります。
Stream は読み取って完了します。
public:
static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- utf8Json
- Stream
解析する JSON データ。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
utf8Json または jsonTypeInfo が null。
JSON が無効であるか、ストリームに残りのデータがあります。
適用対象
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)
指定されたリーダーから 1 つの JSON 値 (オブジェクトまたは配列を含む) を returnTypeに読み取ります。
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- reader
- Utf8JsonReader
読み取るリーダー。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnType または context が null。
JSON が無効であるか、 returnType が JSON と互換性がない、または値をリーダーから読み取れませんでした。
reader はサポートされていないオプションを使用しています。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、returnTypeの互換性のあるJsonTypeInfoを返しませんでした。
注釈
readerのTokenType プロパティがPropertyNameまたはNoneの場合、リーダーは 1 回の呼び出しで値の開始を決定するためにRead()されます。
このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。
このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。
Utf8JsonReaderのインスタンスの作成に使用されるJsonReaderOptionsは、競合時にJsonSerializerOptionsよりも優先されます。 したがって、 AllowTrailingCommas、 MaxDepth、および CommentHandling は読み取り中に使用されます。
適用対象
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)
指定されたリーダーから 1 つの JSON 値 (オブジェクトまたは配列を含む) を読み取り、それを指定した型のインスタンスに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object Deserialize(ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectPublic Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- reader
- Utf8JsonReader
JSON を読み取るリーダー。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
読み取り中にシリアライザーの動作を制御するオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
returnType は nullです。
reader はサポートされていないオプションを使用しています。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
readerのTokenType プロパティがJsonTokenType.PropertyNameまたはJsonTokenType.Noneの場合、リーダーは 1 回の呼び出しで値の開始を決定するためにUtf8JsonReader.Read()されます。
このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。
このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。
Utf8JsonReaderのインスタンスの作成に使用されるJsonReaderOptionsは、競合時にJsonSerializerOptionsよりも優先されます。 したがって、 JsonReaderOptions.AllowTrailingCommas、 JsonReaderOptions.MaxDepth、および JsonReaderOptions.CommentHandling は読み取り中に使用されます。
詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。
適用対象
Deserialize(JsonNode, Type, JsonSerializerContext)
1 つの JSON 値を表す JsonNode を returnTypeに変換します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、変換する型のnullを返します。
適用対象
Deserialize(JsonNode, Type, JsonSerializerOptions)
1 つの JSON 値を表す JsonNode を returnTypeに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
returnType は JSON と互換性がありません。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize(JsonElement, Type, JsonSerializerContext)
1 つの JSON 値を表す JsonElement を returnTypeに変換します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- element
- JsonElement
変換する JsonElement 。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、変換する型のnullを返します。
適用対象
Deserialize(JsonElement, Type, JsonSerializerOptions)
1 つの JSON 値を表す JsonElement を returnTypeに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- element
- JsonElement
変換する JsonElement 。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
returnType は nullです。
returnType は JSON と互換性がありません。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize(JsonDocument, Type, JsonSerializerContext)
1 つの JSON 値を表す JsonDocument を returnTypeに変換します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- document
- JsonDocument
変換する JsonDocument 。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、変換する型のnullを返します。
適用対象
Deserialize(JsonDocument, Type, JsonSerializerOptions)
1 つの JSON 値を表す JsonDocument を returnTypeに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- document
- JsonDocument
変換する JsonDocument 。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
document または returnType が null。
returnType は JSON と互換性がありません。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize(String, Type, JsonSerializerOptions)
1 つの JSON 値を表すテキストを、指定した型のインスタンスに解析します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object Deserialize(string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectPublic Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- json
- String
解析する JSON テキスト。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
json または returnType が null。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。
適用対象
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
1 つの JSON 値を表すテキストを returnTypeに解析します。
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- json
- ReadOnlySpan<Char>
解析する JSON テキスト。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、変換する型のnullを返します。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
適用対象
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
1 つの JSON 値を表すテキストを、指定した型のインスタンスに解析します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- json
- ReadOnlySpan<Char>
解析する JSON テキスト。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
returnType は nullです。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
UTF-16 スパンの使用は、UTF-8 メソッドを使用する場合ほど効率的ではありません。実装では UTF-8 がネイティブに使用されるためです。
適用対象
Deserialize(String, Type, JsonSerializerContext)
1 つの JSON 値を表すテキストを returnTypeに解析します。
public:
static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- json
- String
解析する JSON テキスト。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、変換する型のnullを返します。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
適用対象
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、指定した型のインスタンスに解析します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object Deserialize(ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectPublic Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- utf8Json
- ReadOnlySpan<Byte>
解析する JSON テキスト。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
returnType は nullです。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。
適用対象
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、 jsonTypeInfoで指定されたインスタンスに解析します。
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- utf8Json
- ReadOnlySpan<Byte>
解析する JSON テキスト。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
JSON が無効であるか、バッファーに残りのデータがあります。
適用対象
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを returnTypeに解析します。
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- utf8Json
- ReadOnlySpan<Byte>
解析する JSON テキスト。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
returnType は nullです。
JSON が無効です。 returnType は JSON と互換性がありません。または、Stream に残りのデータがあります。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、returnTypeの互換性のあるJsonTypeInfoを返しませんでした。
適用対象
Deserialize(String, JsonTypeInfo)
1 つの JSON 値を表すテキストを、 jsonTypeInfoで指定されたインスタンスに解析します。
public:
static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- json
- String
解析する JSON テキスト。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
適用対象
Deserialize(JsonDocument, JsonTypeInfo)
1 つの JSON 値を表す JsonDocument を、 jsonTypeInfoで指定されたインスタンスに変換します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- document
- JsonDocument
変換する JsonDocument 。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
適用対象
Deserialize(JsonElement, JsonTypeInfo)
1 つの JSON 値を表す JsonElement を、 jsonTypeInfoで指定されたインスタンスに変換します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- element
- JsonElement
変換する JsonElement 。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
jsonTypeInfo は nullです。
適用対象
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
1 つの JSON 値を表すテキストを、 jsonTypeInfoで指定されたインスタンスに解析します。
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- json
- ReadOnlySpan<Char>
解析する JSON テキスト。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
jsonTypeInfo は nullです。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
適用対象
Deserialize(Utf8JsonReader, JsonTypeInfo)
指定されたリーダーから 1 つの JSON 値 (オブジェクトまたは配列を含む) を、 jsonTypeInfoで指定されたインスタンスに読み取ります。
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- reader
- Utf8JsonReader
読み取るリーダー。
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
JSON が無効であるか、 jsonTypeInfo が JSON と互換性がない、または値をリーダーから読み取れませんでした。
reader はサポートされていないオプションを使用しています。
注釈
readerのTokenType プロパティがPropertyNameまたはNoneの場合、リーダーは 1 回の呼び出しで値の開始を決定するためにRead()されます。
このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。
このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。
Utf8JsonReaderのインスタンスの作成に使用されるJsonReaderOptionsは、競合時にJsonSerializerOptionsよりも優先されます。 したがって、 AllowTrailingCommas、 MaxDepth、および CommentHandling は読み取り中に使用されます。
適用対象
Deserialize(Stream, Type, JsonSerializerOptions)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを returnTypeに読み取ります。
Stream は読み取って完了します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static object? Deserialize(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object? Deserialize(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> objstatic member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Objectパラメーター
- utf8Json
- Stream
解析する JSON データ。
- returnType
- Type
変換して返すオブジェクトの型。
- options
- JsonSerializerOptions
読み取り中の動作を制御するオプション。
返品
JSON 値の returnType 表現。
- 属性
例外
utf8Json または returnType が null。
JSON が無効であるか、 returnType が JSON と互換性がない、またはストリームに残りのデータがある。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize(Stream, Type, JsonSerializerContext)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを returnTypeに読み取ります。
Stream は読み取って完了します。
public:
static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize(System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Objectパラメーター
- utf8Json
- Stream
解析する JSON データ。
- returnType
- Type
変換して返すオブジェクトの型。
- context
- JsonSerializerContext
シリアル化可能な型のメタデータ プロバイダー。
返品
JSON 値の returnType 表現。
例外
utf8Json、 returnType、または context が null。
JSON が無効であるか、 returnType が JSON と互換性がない、またはストリームに残りのデータがある。
returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
指定されたcontextのGetTypeInfo(Type) メソッドは、returnTypeの互換性のあるJsonTypeInfoを返しませんでした。
適用対象
Deserialize(JsonNode, JsonTypeInfo)
1 つの JSON 値を表す JsonNode を、 jsonTypeInfoで指定されたインスタンスに変換します。
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize(this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Objectパラメーター
- jsonTypeInfo
- JsonTypeInfo
変換する型に関するメタデータ。
返品
JSON 値の jsonTypeInfo 表現。
例外
jsonTypeInfo は nullです。
適用対象
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
1 つの JSON 値を表す JsonDocument を TValueに変換します。
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- document
- JsonDocument
変換する JsonDocument 。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
TValue は JSON と互換性がありません。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
指定されたリーダーから 1 つの JSON 値 (オブジェクトまたは配列を含む) を TValueに読み取ります。
public:
generic <typename TValue>
static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- reader
- Utf8JsonReader
読み取るリーダー。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
JSON が無効であるか、 TValue が JSON と互換性がない、または値をリーダーから読み取れませんでした。
reader はサポートされていないオプションを使用しています。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
readerのTokenType プロパティがPropertyNameまたはNoneの場合、リーダーは 1 回の呼び出しで値の開始を決定するためにRead()されます。
このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。
このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。
Utf8JsonReaderのインスタンスの作成に使用されるJsonReaderOptionsは、競合時にJsonSerializerOptionsよりも優先されます。 したがって、 AllowTrailingCommas、 MaxDepth、および CommentHandling は読み取り中に使用されます。
適用対象
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)
指定されたリーダーから、ジェネリック型パラメーターで指定された型のインスタンスに 1 つの JSON 値 (オブジェクトまたは配列を含む) を読み取ります。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);public static TValue Deserialize<TValue>(ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValuePublic Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値のターゲット型。
パラメーター
- reader
- Utf8JsonReader
JSON を読み取るリーダー。
- options
- JsonSerializerOptions
読み取り中にシリアライザーの動作を制御するオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
reader では、サポートされていないオプションが使用されます。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
readerのTokenType プロパティがJsonTokenType.PropertyNameまたはJsonTokenType.Noneの場合、リーダーは 1 回の呼び出しで値の開始を決定するためにUtf8JsonReader.Read()されます。
このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。
このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。
Utf8JsonReaderのインスタンスの作成に使用されるJsonReaderOptionsは、競合時にJsonSerializerOptionsよりも優先されます。 したがって、 JsonReaderOptions.AllowTrailingCommas、 JsonReaderOptions.MaxDepth、および JsonReaderOptions.CommentHandling は読み取り中に使用されます。
詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。
適用対象
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)
1 つの JSON 値を表す JsonNode を TValueに変換します。
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
jsonTypeInfo は nullです。
TValue は JSON と互換性がありません。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(JsonNode, JsonSerializerOptions)
1 つの JSON 値を表す JsonNode を TValueに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
TValue は JSON と互換性がありません。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
1 つの JSON 値を表す JsonElement を TValueに変換します。
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- element
- JsonElement
変換する JsonElement 。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
jsonTypeInfo は nullです。
TValue は JSON と互換性がありません。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
1 つの JSON 値を表す JsonElement を TValueに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- element
- JsonElement
変換する JsonElement 。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
TValue は JSON と互換性がありません。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
1 つの JSON 値を表す JsonDocument を TValueに変換します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- document
- JsonDocument
変換する JsonDocument 。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
document は nullです。
TValue は JSON と互換性がありません。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)
単一の JSON 値を表す UTF-8 でエンコードされたテキストを、ジェネリック型パラメーターで指定された型のインスタンスに解析します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue Deserialize<TValue>(ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValuePublic Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
UTF-8 でエンコードされたテキストのターゲット型。
パラメーター
- utf8Json
- ReadOnlySpan<Byte>
解析する JSON テキスト。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。
適用対象
Deserialize<TValue>(String, JsonSerializerOptions)
単一の JSON 値を表すテキストを、ジェネリック型パラメーターで指定された型のインスタンスに解析します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(string json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(string json, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(string json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue Deserialize<TValue>(string json, System.Text.Json.JsonSerializerOptions options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValuePublic Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値のターゲット型。
パラメーター
- json
- String
解析する JSON テキスト。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
json は nullです。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。
適用対象
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
1 つの JSON 値を表すテキストを TValueに解析します。
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- json
- ReadOnlySpan<Char>
解析する JSON テキスト。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
適用対象
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)
単一の JSON 値を表すテキストを、ジェネリック型パラメーターで指定された型のインスタンスに解析します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- json
- ReadOnlySpan<Char>
解析する JSON テキスト。
- options
- JsonSerializerOptions
解析中の動作を制御するためのオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
UTF-16 スパンの使用は、UTF-8 メソッドを使用する場合ほど効率的ではありません。実装では UTF-8 がネイティブに使用されるためです。
適用対象
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを TValueに解析します。
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- utf8Json
- ReadOnlySpan<Byte>
解析する JSON テキスト。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
JSON が無効です。 TValue は JSON と互換性がありません。または、Stream に残りのデータがあります。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを TValueに読み取ります。
Stream は読み取って完了します。
public:
generic <typename TValue>
static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- utf8Json
- Stream
解析する JSON データ。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
utf8Json または jsonTypeInfo が null。
JSON が無効です。 TValue は JSON と互換性がありません。または、Stream に残りのデータがあります。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(Stream, JsonSerializerOptions)
1 つの JSON 値を表す UTF-8 でエンコードされたテキストを TValueに読み取ります。
Stream は読み取って完了します。
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static TValue? Deserialize<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue? Deserialize<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Valuestatic member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- utf8Json
- Stream
解析する JSON データ。
- options
- JsonSerializerOptions
読み取り中の動作を制御するオプション。
返品
TValue
JSON 値の TValue 表現。
- 属性
例外
utf8Json は nullです。
JSON が無効です。 TValue は JSON と互換性がありません。または、Stream に残りのデータがあります。
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
適用対象
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
1 つの JSON 値を表すテキストを TValueに解析します。
public:
generic <typename TValue>
static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue>(string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue型パラメーター
- TValue
JSON 値を逆シリアル化する型。
パラメーター
- json
- String
解析する JSON テキスト。
- jsonTypeInfo
- JsonTypeInfo<TValue>
変換する型に関するメタデータ。
返品
TValue
JSON 値の TValue 表現。
例外
TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。
注釈
実装では UTF-8 がネイティブに使用されるため、 String の使用は UTF-8 メソッドを使用するほど効率的ではありません。
