JsonSerializer.SerializeAsync 메서드

참조

정의

네임스페이스:: System.Text.Json

어셈블리:: System.Text.Json.dll

패키지:: System.Text.Json v8.0.4

패키지:: System.Text.Json v9.0.0-rc.1.24431.7

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

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

Source:: JsonSerializer.Write.Stream.cs

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(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken)

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

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

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

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

매개 변수

utf8Json: PipeWriter

쓸 UTF-8 PipeWriter.

value: Object

변환할 값입니다.

inputType: Type

변환할 value 형식입니다.

context: JsonSerializerContext

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

cancellationToken: CancellationToken

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

반환

Task

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

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

utf8Json, inputType또는 contextnull.

NotSupportedException

호환되는 JsonConverter 없습니다.

inputType 또는 직렬화할 수 있는 멤버의 경우

적용 대상

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

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

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);

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 Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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직렬화 및 역직렬화하는 방법을 참조하세요.

적용 대상

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

Source:: JsonSerializer.Write.Stream.cs

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(PipeWriter, Object, JsonTypeInfo, CancellationToken)

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

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

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

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

매개 변수

utf8Json: PipeWriter

쓸 UTF-8 PipeWriter.

value: Object

변환할 값입니다.

jsonTypeInfo: JsonTypeInfo

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

cancellationToken: CancellationToken

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

반환

Task

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

예외

ArgumentNullException

utf8Json null.

InvalidCastException

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

적용 대상

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

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

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

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

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

매개 변수

utf8Json: PipeWriter

쓸 UTF-8 PipeWriter.

value: Object

변환할 값입니다.

inputType: Type

변환할 value 형식입니다.

options: JsonSerializerOptions

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

cancellationToken: CancellationToken

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

반환

Task

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

예외

ArgumentException

inputType value호환되지 않습니다.

ArgumentNullException

utf8Json 또는 inputTypenull.

NotSupportedException

호환되는 JsonConverter 없습니다.

inputType 또는 직렬화할 수 있는 멤버의 경우

적용 대상

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

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

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

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

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

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

utf8Json: PipeWriter

쓸 UTF-8 PipeWriter.

value: TValue

변환할 값입니다.

options: JsonSerializerOptions

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

cancellationToken: CancellationToken

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

반환

Task

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

예외

ArgumentNullException

utf8Json null.

NotSupportedException

호환되는 JsonConverter 없습니다.

TValue 또는 직렬화할 수 있는 멤버의 경우

적용 대상

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

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

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

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

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

형식 매개 변수

TValue

serialize할 값의 형식입니다.

매개 변수

utf8Json: PipeWriter

쓸 UTF-8 PipeWriter.

value: TValue

변환할 값입니다.

jsonTypeInfo: JsonTypeInfo<TValue>

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

cancellationToken: CancellationToken

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

반환

Task

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

예외

ArgumentNullException

utf8Json null.

적용 대상

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

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

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);

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 Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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

Source:: JsonSerializer.Write.Stream.cs

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

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

적용 대상

다음을 통해 공유

JsonSerializer.SerializeAsync 메서드

정의

오버로드

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

매개 변수

반환

예외

설명

적용 대상

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

매개 변수

반환

예외

적용 대상

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

매개 변수

반환

예외

설명

적용 대상

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

매개 변수

반환

예외

적용 대상

SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken)

매개 변수

반환

예외

적용 대상

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

매개 변수

반환

예외

적용 대상

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

형식 매개 변수

매개 변수

반환

예외

적용 대상

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

형식 매개 변수

매개 변수

반환

예외

적용 대상

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

형식 매개 변수

매개 변수

반환

예외

설명

적용 대상

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

형식 매개 변수

매개 변수

반환

예외

적용 대상

추가 리소스