JsonSerializer.DeserializeAsync メソッド

定義

名前空間:: System.Text.Json

アセンブリ:: System.Text.Json.dll

パッケージ:: System.Text.Json v11.0.0-preview.4.26230.115

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを `returnType`に読み取ります。 Stream は読み取って完了します。
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、指定した型のインスタンスに非同期的に読み取ります。ストリームは完了まで読み取られます。
DeserializeAsync(PipeReader, Type, JsonSerializerContext, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを `returnType`に読み取ります。 PipeReader は完了まで読み取られます。
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、 `jsonTypeInfo`で指定されたインスタンスに読み取ります。 Stream は読み取って完了します。
DeserializeAsync(PipeReader, JsonTypeInfo, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、 `jsonTypeInfo`で指定されたインスタンスに読み取ります。 PipeReader は完了まで読み取られます。
DeserializeAsync(PipeReader, Type, JsonSerializerOptions, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを `returnType`に読み取ります。 PipeReader は完了まで読み取られます。
DeserializeAsync<TValue>(PipeReader, JsonSerializerOptions, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを `TValue`に読み取ります。 PipeReader は完了まで読み取られます。
DeserializeAsync<TValue>(PipeReader, JsonTypeInfo<TValue>, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを `TValue`に読み取ります。 PipeReader は完了まで読み取られます。
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)	単一の JSON 値を表す UTF-8 でエンコードされたテキストを、ジェネリック型パラメーターで指定された型のインスタンスに非同期的に読み取ります。ストリームは完了まで読み取られます。
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)	1 つの JSON 値を表す UTF-8 でエンコードされたテキストを `TValue`に読み取ります。 Stream は読み取って完了します。

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを returnTypeに読み取ります。 Stream は読み取って完了します。

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);

static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

パラメーター

utf8Json: Stream

解析する JSON データ。

returnType: Type

変換して返すオブジェクトの型。

context: JsonSerializerContext

シリアル化可能な型のメタデータプロバイダー。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<Object>

JSON 値の returnType 表現。

例外

ArgumentNullException

utf8Json、 returnType、または context が null。

JsonException

JSON が無効であるか、 returnType が JSON と互換性がない、またはストリームに残りのデータがある。

NotSupportedException

returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

InvalidOperationException

指定されたcontextのGetTypeInfo(Type) メソッドは、returnTypeの互換性のあるJsonTypeInfoを返しませんでした。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 Deserialize(Stream, Type, JsonSerializerContext)によってスローされる例外を参照してください。

適用対象

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

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 System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = 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 System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

public static System.Threading.Tasks.ValueTask<object> DeserializeAsync(System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = 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 DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<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 DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

パラメーター

utf8Json: Stream

解析する JSON データ。

returnType: Type

変換して返すオブジェクトの型。

options: JsonSerializerOptions

読み取り中の動作を制御するオプション。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できるキャンセルトークン。

返品

ValueTask<Object>

JSON 値の returnType 表現。

属性: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

例外

ArgumentNullException

utf8Json または returnType が null。

JsonException

JSON が無効です。

-又は-

TValue は JSON と互換性がありません。

-又は-

ストリームに残りのデータがあります。

NotSupportedException

returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 Deserialize(Stream, Type, JsonSerializerOptions)によってスローされる例外を参照してください。

適用対象

DeserializeAsync(PipeReader, Type, JsonSerializerContext, CancellationToken)

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを returnTypeに読み取ります。

PipeReader は完了まで読み取られます。

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);

static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

Public Function DeserializeAsync (utf8Json As PipeReader, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

パラメーター

utf8Json: PipeReader

解析する JSON データ。

returnType: Type

変換して返すオブジェクトの型。

context: JsonSerializerContext

シリアル化可能な型のメタデータプロバイダー。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<Object>

JSON 値の returnType 表現。

例外

ArgumentNullException

utf8Json、 returnType、または context が null。

JsonException

JSON が無効であるか、 returnType が JSON と互換性がない、または PipeReader に残りのデータがある。

NotSupportedException

returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

InvalidOperationException

指定されたcontextのGetTypeInfo(Type) メソッドは、returnTypeの互換性のあるJsonTypeInfoを返しませんでした。

適用対象

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、 jsonTypeInfoで指定されたインスタンスに読み取ります。 Stream は読み取って完了します。

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

Public Function DeserializeAsync (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

パラメーター

utf8Json: Stream

解析する JSON データ。

jsonTypeInfo: JsonTypeInfo

変換する型に関するメタデータ。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<Object>

JSON 値の jsonTypeInfo 表現。

例外

ArgumentNullException

utf8Json または jsonTypeInfo が null。

JsonException

JSON が無効であるか、ストリームに残りのデータがあります。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

適用対象

DeserializeAsync(PipeReader, JsonTypeInfo, CancellationToken)

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを、 jsonTypeInfoで指定されたインスタンスに読み取ります。

PipeReader は完了まで読み取られます。

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

Public Function DeserializeAsync (utf8Json As PipeReader, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

パラメーター

utf8Json: PipeReader

解析する JSON データ。

jsonTypeInfo: JsonTypeInfo

変換する型に関するメタデータ。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<Object>

JSON 値の jsonTypeInfo 表現。

例外

ArgumentNullException

utf8Json または jsonTypeInfo が null。

JsonException

JSON が無効であるか、PipeReader に残りのデータがあります。

適用対象

DeserializeAsync(PipeReader, Type, JsonSerializerOptions, CancellationToken)

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを returnTypeに読み取ります。

PipeReader は完了まで読み取られます。

[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 System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = 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 DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>

Public Function DeserializeAsync (utf8Json As PipeReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

パラメーター

utf8Json: PipeReader

解析する JSON データ。

returnType: Type

変換して返すオブジェクトの型。

options: JsonSerializerOptions

読み取り中の動作を制御するオプション。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<Object>

JSON 値の returnType 表現。

属性: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

例外

ArgumentNullException

utf8Json または returnType が null。

JsonException

JSON が無効であるか、 returnType が JSON と互換性がない、または PipeReader に残りのデータがある。

NotSupportedException

returnTypeまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

適用対象

DeserializeAsync<TValue>(PipeReader, JsonSerializerOptions, CancellationToken)

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを TValueに読み取ります。

PipeReader は完了まで読み取られます。

[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 System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = 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 DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>

static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>

Public Function DeserializeAsync(Of TValue) (utf8Json As PipeReader, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

型パラメーター

TValue

JSON 値を逆シリアル化する型。

パラメーター

utf8Json: PipeReader

解析する JSON データ。

options: JsonSerializerOptions

読み取り中の動作を制御するオプション。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<TValue>

JSON 値の TValue 表現。

属性: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

例外

ArgumentNullException

utf8Json は nullです。

JsonException

JSON が無効です。 TValue は JSON と互換性がありません。または、PipeReader に残りのデータがあります。

NotSupportedException

TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

適用対象

DeserializeAsync<TValue>(PipeReader, JsonTypeInfo<TValue>, CancellationToken)

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

ソース:: JsonSerializer.Read.Pipe.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを TValueに読み取ります。

PipeReader は完了まで読み取られます。

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>

Public Function DeserializeAsync(Of TValue) (utf8Json As PipeReader, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

型パラメーター

TValue

JSON 値を逆シリアル化する型。

パラメーター

utf8Json: PipeReader

解析する JSON データ。

jsonTypeInfo: JsonTypeInfo<TValue>

変換する型に関するメタデータ。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<TValue>

JSON 値の TValue 表現。

例外

ArgumentNullException

utf8Json または jsonTypeInfo が null。

JsonException

JSON が無効です。 TValue は JSON と互換性がありません。または、PipeReader に残りのデータがあります。

適用対象

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

単一の 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 System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = 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 System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

public static System.Threading.Tasks.ValueTask<TValue> DeserializeAsync<TValue>(System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = 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 DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>

static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'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 DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>

Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

型パラメーター

TValue

JSON 値のターゲット型。

パラメーター

utf8Json: Stream

解析する JSON データ。

options: JsonSerializerOptions

読み取り中の動作を制御するオプション。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できるトークン。

返品

ValueTask<TValue>

JSON 値の TValue 表現。

属性: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

例外

JsonException

JSON が無効です。

-又は-

TValue は JSON と互換性がありません。

-又は-

ストリームに残りのデータがあります。

NotSupportedException

TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

ArgumentNullException

utf8Jsonが null。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

詳細については、「 JSON をシリアル化および逆シリアル化する方法」を参照してください。

適用対象

DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

ソース:: JsonSerializer.Read.Stream.cs

1 つの JSON 値を表す UTF-8 でエンコードされたテキストを TValueに読み取ります。 Stream は読み取って完了します。

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>

Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

型パラメーター

TValue

JSON 値を逆シリアル化する型。

パラメーター

utf8Json: Stream

解析する JSON データ。

jsonTypeInfo: JsonTypeInfo<TValue>

変換する型に関するメタデータ。

cancellationToken: CancellationToken

読み取り操作を取り消すために使用できる CancellationToken 。

返品

ValueTask<TValue>

JSON 値の TValue 表現。

例外

ArgumentNullException

utf8Json または jsonTypeInfo が null。

JsonException

JSON が無効です。 TValue は JSON と互換性がありません。または、Stream に残りのデータがあります。

NotSupportedException

TValueまたはそのシリアル化可能なメンバーに互換性のあるJsonConverterはありません。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

適用対象

フィードバック

このページはお役に立ちましたか?