Utf8JsonWriter 클래스

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

패키지:

System.Text.Json v9.0.0-rc.1.24431.7

Source:

Utf8JsonWriter.cs

UTF-8로 인코딩된 JSON 텍스트의 정방향 전용, 캐시되지 않은 쓰기를 위한 고성능 API를 제공합니다.

public ref class Utf8JsonWriter sealed : IAsyncDisposable, IDisposable

public sealed class Utf8JsonWriter : IAsyncDisposable, IDisposable

type Utf8JsonWriter = class
    interface IDisposable
    interface IAsyncDisposable

Public NotInheritable Class Utf8JsonWriter
Implements IAsyncDisposable, IDisposable

상속

Object

Utf8JsonWriter

구현

IAsyncDisposable IDisposable

설명

Utf8JsonWriter 캐싱 없이 텍스트를 순차적으로 작성하고 기본적으로 주석 작성을 제외하고 JSON RFC준수합니다.

유효성 검사를 사용할 때 잘못된 JSON을 쓰려고 시도하는 메서드는 컨텍스트별 오류 메시지와 함께 InvalidOperationException throw합니다.

들여쓰기 및 공백으로 출력의 서식을 지정하거나 유효성 검사를 건너뛰거나 이스케이프 동작을 사용자 지정하려면 JsonWriterOptions 인스턴스를 만들고 기록기에 전달합니다.

자세한 내용은 System.Text.Json사용하여 사용자 지정 직렬 변환기 및 역직렬 변환기를 작성하는 방법을 참조하세요.

생성자

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)	지정된 IBufferWriter<T> 사용하여 출력 및 사용자 지정 옵션을 사용하여 Utf8JsonWriter 클래스의 새 인스턴스를 초기화합니다.
Utf8JsonWriter(Stream, JsonWriterOptions)	지정된 스트림을 사용하여 출력 및 사용자 지정 옵션을 작성하여 Utf8JsonWriter 클래스의 새 인스턴스를 초기화합니다.

속성

BytesCommitted	지금까지 현재 인스턴스에서 출력에 커밋된 총 바이트 수를 가져옵니다.
BytesPending	아직 출력으로 플러시되고 커밋되지 않은 Utf8JsonWriter 의해 작성된 바이트 수를 가져옵니다.
CurrentDepth	현재 토큰의 깊이를 가져옵니다.
Options	이 인스턴스를 사용하여 JSON을 작성할 때 사용자 지정 동작을 가져옵니다. 이 동작은 작성하는 동안 출력의 서식을 지정할지 여부, 구조적 JSON 유효성 검사를 건너뛸지 여부 및 이스케이프할 문자를 나타냅니다.

메서드

Dispose()	아직 플러시되지 않은 남은 JSON 텍스트를 커밋하고 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.
DisposeAsync()	아직 플러시되지 않은 남은 JSON 텍스트를 비동기적으로 커밋하고 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
Flush()	지금까지 작성된 JSON 텍스트를 커밋하여 출력 대상에 표시합니다.
FlushAsync(CancellationToken)	지금까지 작성된 JSON 텍스트를 비동기적으로 커밋하여 출력 대상에 표시합니다.
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
Reset()	다시 사용할 수 있도록 이 인스턴스의 내부 상태를 다시 설정합니다.
Reset(IBufferWriter<Byte>)	새 IBufferWriter<T>인스턴스와 함께 다시 사용할 수 있도록 이 인스턴스의 내부 상태를 다시 설정합니다.
Reset(Stream)	새 Stream인스턴스와 함께 다시 사용할 수 있도록 이 인스턴스의 내부 상태를 다시 설정합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)	미리 인코딩된 속성 이름 및 원시 바이트 값(Base64로 인코딩된 JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	속성 이름 및 원시 바이트 값(Base64로 인코딩된 JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	속성 이름 및 원시 바이트 값(Base64로 인코딩된 JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteBase64String(String, ReadOnlySpan<Byte>)	속성 이름 및 원시 바이트 값(Base64로 인코딩된 JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteBase64StringValue(ReadOnlySpan<Byte>)	원시 바이트 값을 Base64로 인코딩된 JSON 문자열로 JSON 배열의 요소로 씁니다.
WriteBoolean(JsonEncodedText, Boolean)	미리 인코딩된 속성 이름 및 Boolean 값(JSON 리터럴 true 또는 false)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteBoolean(ReadOnlySpan<Byte>, Boolean)	JSON 개체의 이름/값 쌍의 일부로 읽기 전용 바이트 범위로 지정된 속성 이름 및 Boolean 값(JSON 리터럴 true 또는 false)을 씁니다.
WriteBoolean(ReadOnlySpan<Char>, Boolean)	JSON 개체의 이름/값 쌍의 일부로 읽기 전용 문자 범위로 지정된 속성 이름 및 Boolean 값(JSON 리터럴 true 또는 false)을 씁니다.
WriteBoolean(String, Boolean)	JSON 개체의 이름/값 쌍의 일부로 문자열 및 값으로 지정된 속성 이름(JSON 리터럴 true 또는 false)을 씁니다.
WriteBooleanValue(Boolean)	값을 JSON 배열의 요소로 작성합니다(JSON 리터럴 true 또는 false).
WriteCommentValue(ReadOnlySpan<Byte>)	UTF-8 텍스트 값을 JSON 주석으로 씁니다.
WriteCommentValue(ReadOnlySpan<Char>)	UTF-16 텍스트 값을 JSON 주석으로 씁니다.
WriteCommentValue(String)	문자열 텍스트 값을 JSON 주석으로 씁니다.
WriteEndArray()	JSON 배열의 끝을 씁니다.
WriteEndObject()	JSON 개체의 끝을 씁니다.
WriteNull(JsonEncodedText)	미리 인코딩된 속성 이름 및 JSON 리터럴 null JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNull(ReadOnlySpan<Byte>)	JSON 개체의 이름/값 쌍의 일부로 읽기 전용 바이트 범위로 지정된 속성 이름과 null JSON 리터럴을 씁니다.
WriteNull(ReadOnlySpan<Char>)	JSON 개체의 이름/값 쌍의 일부로 읽기 전용 문자 범위로 지정된 속성 이름과 null JSON 리터럴을 씁니다.
WriteNull(String)	문자열로 지정된 속성 이름과 JSON 리터럴 null JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNullValue()	JSON 리터럴 null JSON 배열의 요소로 씁니다.
WriteNumber(JsonEncodedText, Decimal)	미리 인코딩된 속성 이름 및 Decimal 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(JsonEncodedText, Double)	미리 인코딩된 속성 이름 및 Double 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(JsonEncodedText, Int32)	미리 인코딩된 속성 이름 및 Int32 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(JsonEncodedText, Int64)	미리 인코딩된 속성 이름 및 Int64 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(JsonEncodedText, Single)	미리 인코딩된 속성 이름 및 Single 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(JsonEncodedText, UInt32)	미리 인코딩된 속성 이름 및 UInt32 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(JsonEncodedText, UInt64)	미리 인코딩된 속성 이름 및 UInt64 값(JSON 번호)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteNumber(ReadOnlySpan<Byte>, Decimal)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Decimal 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Byte>, Double)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Double 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Byte>, Int32)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Int32 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Byte>, Int64)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Int64 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Byte>, Single)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Single 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Byte>, UInt32)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UInt32 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Byte>, UInt64)	읽기 전용 바이트 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UInt64 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, Decimal)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Decimal 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, Double)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Double 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, Int32)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Int32 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, Int64)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Int64 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, Single)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Single 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, UInt32)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UInt32 값(JSON 번호)을 씁니다.
WriteNumber(ReadOnlySpan<Char>, UInt64)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UInt64 값(JSON 번호)을 씁니다.
WriteNumber(String, Decimal)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Decimal 값(JSON 번호)을 씁니다.
WriteNumber(String, Double)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Double 값(JSON 번호)을 씁니다.
WriteNumber(String, Int32)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Int32 값(JSON 번호)을 씁니다.
WriteNumber(String, Int64)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Int64 값(JSON 번호)을 씁니다.
WriteNumber(String, Single)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Single 값(JSON 번호)을 씁니다.
WriteNumber(String, UInt32)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UInt32 값(JSON 번호)을 씁니다.
WriteNumber(String, UInt64)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UInt64 값(JSON 번호)을 씁니다.
WriteNumberValue(Decimal)	JSON 배열의 요소로 Decimal 값(JSON 숫자)을 씁니다.
WriteNumberValue(Double)	JSON 배열의 요소로 Double 값(JSON 숫자)을 씁니다.
WriteNumberValue(Int32)	JSON 배열의 요소로 Int32 값을 JSON 번호로 씁니다.
WriteNumberValue(Int64)	JSON 배열의 요소로 Int64 값을 JSON 번호로 씁니다.
WriteNumberValue(Single)	JSON 배열의 요소로 Single 값(JSON 숫자)을 씁니다.
WriteNumberValue(UInt32)	JSON 배열의 요소로 UInt32 값(JSON 숫자)을 씁니다.
WriteNumberValue(UInt64)	JSON 배열의 요소로 UInt64 값(JSON 숫자)을 씁니다.
WritePropertyName(JsonEncodedText)	미리 인코딩된 속성 이름(JSON 문자열)을 JSON 개체의 이름/값 쌍의 첫 번째 부분으로 씁니다.
WritePropertyName(ReadOnlySpan<Byte>)	UTF-8 속성 이름(JSON 문자열)을 JSON 개체의 이름/값 쌍의 첫 번째 부분으로 씁니다.
WritePropertyName(ReadOnlySpan<Char>)	속성 이름(JSON 문자열)을 JSON 개체의 이름/값 쌍의 첫 번째 부분으로 씁니다.
WritePropertyName(String)	속성 이름(JSON 문자열)을 JSON 개체의 이름/값 쌍의 첫 번째 부분으로 씁니다.
WriteRawValue(ReadOnlySequence<Byte>, Boolean)	입력을 JSON 콘텐츠로 씁니다. 입력 콘텐츠는 완전한 단일 JSON 값일 것으로 예상됩니다.
WriteRawValue(ReadOnlySpan<Byte>, Boolean)	입력을 JSON 콘텐츠로 씁니다. 입력 콘텐츠는 완전한 단일 JSON 값일 것으로 예상됩니다.
WriteRawValue(ReadOnlySpan<Char>, Boolean)	입력을 JSON 콘텐츠로 씁니다. 입력 콘텐츠는 완전한 단일 JSON 값일 것으로 예상됩니다.
WriteRawValue(String, Boolean)	입력을 JSON 콘텐츠로 씁니다. 입력 콘텐츠는 완전한 단일 JSON 값일 것으로 예상됩니다.
WriteStartArray()	JSON 배열의 시작을 씁니다.
WriteStartArray(JsonEncodedText)	미리 인코딩된 속성 이름을 키로 사용하여 JSON 배열의 시작을 씁니다.
WriteStartArray(ReadOnlySpan<Byte>)	읽기 전용 바이트 범위로 지정된 속성 이름을 키로 사용하여 JSON 배열의 시작을 씁니다.
WriteStartArray(ReadOnlySpan<Char>)	읽기 전용 문자 범위로 지정된 속성 이름을 키로 사용하여 JSON 배열의 시작을 씁니다.
WriteStartArray(String)	문자열로 지정된 속성 이름을 키로 사용하여 JSON 배열의 시작을 씁니다.
WriteStartObject()	JSON 개체의 시작을 씁니다.
WriteStartObject(JsonEncodedText)	미리 인코딩된 속성 이름을 키로 사용하여 JSON 개체의 시작을 씁니다.
WriteStartObject(ReadOnlySpan<Byte>)	읽기 전용 바이트 범위로 지정된 속성 이름을 키로 사용하여 JSON 개체의 시작을 씁니다.
WriteStartObject(ReadOnlySpan<Char>)	읽기 전용 문자 범위로 지정된 속성 이름을 키로 사용하여 JSON 개체의 시작을 씁니다.
WriteStartObject(String)	문자열로 지정된 속성 이름을 키로 사용하여 JSON 개체의 시작을 씁니다.
WriteString(JsonEncodedText, DateTime)	미리 인코딩된 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(JsonEncodedText, DateTimeOffset)	미리 인코딩된 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(JsonEncodedText, Guid)	미리 인코딩된 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(JsonEncodedText, JsonEncodedText)	미리 인코딩된 속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	미리 인코딩된 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	미리 인코딩된 속성 이름 및 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(JsonEncodedText, String)	미리 인코딩된 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(ReadOnlySpan<Byte>, DateTime)	UTF-8 속성 이름과 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	UTF-8 속성 이름과 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(ReadOnlySpan<Byte>, Guid)	UTF-8 속성 이름과 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	UTF-8 속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	JSON 개체의 이름/값 쌍의 일부로 UTF-8 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	JSON 개체의 이름/값 쌍의 일부로 UTF-8 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Byte>, String)	JSON 개체의 이름/값 쌍의 일부로 UTF-8 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Char>, DateTime)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 DateTime 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 DateTimeOffset 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Char>, Guid)	읽기 전용 문자 범위로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Guid 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	JSON 개체의 이름/값 쌍의 일부로 UTF-16 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	JSON 개체의 이름/값 쌍의 일부로 UTF-16 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 씁니다.
WriteString(ReadOnlySpan<Char>, String)	JSON 개체의 이름/값 쌍의 일부로 UTF-16 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 씁니다.
WriteString(String, DateTime)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 DateTime 값(JSON 문자열)을 씁니다.
WriteString(String, DateTimeOffset)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 DateTimeOffset 값(JSON 문자열)을 씁니다.
WriteString(String, Guid)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 Guid 값(JSON 문자열)을 씁니다.
WriteString(String, JsonEncodedText)	속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteString(String, ReadOnlySpan<Byte>)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UTF-8 텍스트 값(JSON 문자열)을 씁니다.
WriteString(String, ReadOnlySpan<Char>)	문자열로 지정된 속성 이름과 JSON 개체의 이름/값 쌍의 일부로 UTF-16 텍스트 값(JSON 문자열)을 씁니다.
WriteString(String, String)	문자열로 지정된 속성 이름과 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 씁니다.
WriteStringValue(DateTime)	DateTime 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.
WriteStringValue(DateTimeOffset)	DateTimeOffset 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.
WriteStringValue(Guid)	Guid 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.
WriteStringValue(JsonEncodedText)	미리 인코딩된 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.
WriteStringValue(ReadOnlySpan<Byte>)	UTF-8 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.
WriteStringValue(ReadOnlySpan<Char>)	UTF-16 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.
WriteStringValue(String)	문자열 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 씁니다.

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

비동기 삭제 가능 파일에서 반환된 작업에 대한 대기가 수행되는 방법을 구성합니다.