JsonSerializer.SerializeAsync 메서드

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

오버로드

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)	지정된 형식의 값을 UTF-8로 인코딩된 JSON 텍스트로 비동기적으로 변환하고 지정된 스트림에 씁니다.
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)	제네릭 형식 매개 변수로 지정된 형식의 값을 UTF-8로 인코딩된 JSON 텍스트로 비동기적으로 변환하고 스트림에 씁니다.
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)	제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

Object

변환할 값입니다.

inputType

Type

변환할 value 형식입니다.

context

JsonSerializerContext

직렬화 가능한 형식에 대한 메타데이터 공급자입니다.

cancellationToken

CancellationToken

쓰기 작업을 취소하는 데 사용할 수 있는 CancellationToken.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

utf8Json, inputType또는 contextnull.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 Serialize(Stream, Object, Type, JsonSerializerContext)throw된 예외를 참조하세요.

SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)

Source:

JsonSerializer.Write.Stream.cs

지정된 형식의 값을 UTF-8로 인코딩된 JSON 텍스트로 비동기적으로 변환하고 지정된 스트림에 씁니다.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

utf8Json

Stream

쓸 UTF-8 스트림입니다.

value

Object

변환할 값입니다.

inputType

Type

변환할 value 형식입니다.

options

JsonSerializerOptions

serialization 동작을 제어하는 옵션입니다.

cancellationToken

CancellationToken

쓰기 작업을 취소하는 데 사용할 수 있는 토큰입니다.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

utf8Json 또는 inputTypenull.

NotSupportedException

inputType 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 Serialize(Stream, Object, Type, JsonSerializerOptions)throw된 예외를 참조하세요.

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

Object

변환할 값입니다.

jsonTypeInfo

JsonTypeInfo

변환할 형식에 대한 메타데이터입니다.

cancellationToken

CancellationToken

쓰기 작업을 취소하는 데 사용할 수 있는 CancellationToken.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ArgumentNullException

utf8Json null.

InvalidCastException

value jsonTypeInfo유형과 일치하지 않습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)

Source:

JsonSerializer.Write.Stream.cs

제네릭 형식 매개 변수로 지정된 형식의 값을 UTF-8로 인코딩된 JSON 텍스트로 비동기적으로 변환하고 스트림에 씁니다.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

utf8Json

Stream

쓸 UTF-8 스트림입니다.

value

TValue

변환할 값입니다.

options

JsonSerializerOptions

serialization 동작을 제어하는 옵션입니다.

cancellationToken

CancellationToken

쓰기 작업을 취소하는 데 사용할 수 있는 토큰입니다.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ArgumentNullException

utf8Json null.

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

자세한 내용은 JSON직렬화 및 역직렬화하는 방법을 참조하세요.

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

Source:

JsonSerializer.Write.Stream.cs

제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 Stream씁니다.

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

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

Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

utf8Json

Stream

쓸 UTF-8 Stream.

value

TValue

변환할 값입니다.

jsonTypeInfo

JsonTypeInfo<TValue>

변환할 형식에 대한 메타데이터입니다.

cancellationToken

CancellationToken

쓰기 작업을 취소하는 데 사용할 수 있는 CancellationToken.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ArgumentNullException

utf8Json null.

NotSupportedException

TValue 또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter 없습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.