JsonSerializer.SerializeAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken) |
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 Stream씁니다. |
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken) |
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 씁니다 Stream. |
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken) |
지정된 형식의 값을 UTF-8로 인코딩된 JSON 텍스트로 비동기적으로 변환하고 지정된 스트림에 씁니다. |
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken) |
제공된 값을 UTF-8로 인코딩된 JSON 텍스트로 변환하고 에 Stream씁니다. |
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken) |
제네릭 형식 매개 변수에 지정된 형식의 값을 UTF-8로 인코딩된 JSON 텍스트로 비동기적으로 변환하고 스트림에 씁니다. |
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)
제공된 값을 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
매개 변수
- value
- Object
변환할 값입니다.
- inputType
- Type
변환할 value
의 형식입니다.
- context
- JsonSerializerContext
직렬화 가능한 형식에 대한 메타데이터 공급자입니다.
- cancellationToken
- CancellationToken
CancellationToken 쓰기 작업을 취소하는 데 사용할 수 있는 입니다.
반환
비동기 쓰기 작업을 나타내는 작업입니다.
예외
inputType
이 value
과 호환되지 않는 경우.
utf8Json
, inputType
또는 context
가 null
입니다.
inputType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Serialize(Stream, Object, Type, JsonSerializerContext)된 예외를 참조하세요.
적용 대상
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)
제공된 값을 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
매개 변수
- value
- Object
변환할 값입니다.
- jsonTypeInfo
- JsonTypeInfo
변환할 형식에 대한 메타데이터입니다.
- cancellationToken
- CancellationToken
CancellationToken 쓰기 작업을 취소하는 데 사용할 수 있는 입니다.
반환
비동기 쓰기 작업을 나타내는 작업입니다.
예외
utf8Json
은 null
입니다.
value
가 의 jsonTypeInfo
형식과 일치하지 않습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
적용 대상
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)
지정된 형식의 값을 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
직렬화 동작을 컨트롤하는 옵션입니다.
- cancellationToken
- CancellationToken
쓰기 작업을 취소하는 데 사용할 수 있는 토큰입니다.
반환
비동기 쓰기 작업을 나타내는 작업입니다.
예외
inputType
이 value
과 호환되지 않는 경우.
utf8Json
또는 inputType
가 null
인 경우
inputType
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Serialize(Stream, Object, Type, JsonSerializerOptions)된 예외를 참조하세요.
적용 대상
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)
제공된 값을 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
직렬화할 값의 형식입니다.
매개 변수
- value
- TValue
변환할 값입니다.
- jsonTypeInfo
- JsonTypeInfo<TValue>
변환할 형식에 대한 메타데이터입니다.
- cancellationToken
- CancellationToken
CancellationToken 쓰기 작업을 취소하는 데 사용할 수 있는 입니다.
반환
비동기 쓰기 작업을 나타내는 작업입니다.
예외
utf8Json
이(가) null
인 경우
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
적용 대상
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)
제네릭 형식 매개 변수에 지정된 형식의 값을 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
직렬화할 값의 형식입니다.
매개 변수
- utf8Json
- Stream
쓸 UTF-8 스트림입니다.
- value
- TValue
변환할 값입니다.
- options
- JsonSerializerOptions
직렬화 동작을 컨트롤하는 옵션입니다.
- cancellationToken
- CancellationToken
쓰기 작업을 취소하는 데 사용할 수 있는 토큰입니다.
반환
비동기 쓰기 작업을 나타내는 작업입니다.
예외
utf8Json
이(가) null
인 경우
TValue
또는 직렬화 가능한 멤버에 대해 호환되는 JsonConverter가 없습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
자세한 내용은 JSON을 직렬화 및 역직렬화하는 방법을 참조하세요.
적용 대상
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기