Utf8JsonWriter.WriteString 메서드

참조

정의

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

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

중요

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

오버로드

WriteString(JsonEncodedText, JsonEncodedText)	미리 인코딩된 속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(JsonEncodedText, String)	미리 인코딩된 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	미리 인코딩된 속성 이름 및 텍스트 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	미리 인코딩된 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(JsonEncodedText, Guid)	미리 인코딩된 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(JsonEncodedText, DateTimeOffset)	미리 인코딩된 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(JsonEncodedText, DateTime)	미리 인코딩된 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(String, JsonEncodedText)	속성 이름 및 미리 인코딩된값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(String, String)	문자열로 지정한 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(String, ReadOnlySpan<Char>)	문자열로 지정한 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(String, ReadOnlySpan<Byte>)	문자열로 지정한 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(String, DateTimeOffset)	문자열로 지정한 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(String, DateTime)	문자열로 지정한 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(String, Guid)	문자열로 지정한 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, String)	UTF-16 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, DateTime)	UTF-8 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	UTF-8 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	속성 이름 및 미리 인코딩된값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	UTF-8 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	UTF-8 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, String)	UTF-8 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, Guid)	UTF-8 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, DateTime)	읽기 전용 문자 범위로 지정한 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	읽기 전용 문자 범위로 지정한 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, Guid)	읽기 전용 문자 범위로 지정한 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	UTF-16 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	UTF-16 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	UTF-8 속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

WriteString(JsonEncodedText, JsonEncodedText)

미리 인코딩된 속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: JsonEncodedText

이름/값 쌍의 일부로서 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

인스턴스 JsonEncodedText 를 만들 때 속성 이름 및 값이 이미 이스케이프되어야 합니다.

적용 대상

WriteString(JsonEncodedText, String)

미리 인코딩된 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string? value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string value);

member this.WriteString : System.Text.Json.JsonEncodedText * string -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As String)

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: String

이름/값 쌍의 일부로서 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

인스턴스 JsonEncodedText 를 만들 때 속성 이름은 이미 이스케이프되어야 합니다.

이 값은 쓰기 전에 이스케이프됩니다.

이 null경우 value 메서드가 호출된 것처럼 JSON null 값이 WriteNull(JsonEncodedText) 기록됩니다.

적용 대상

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

미리 인코딩된 속성 이름 및 텍스트 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: ReadOnlySpan<Char>

이름/값 쌍의 일부로서 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

인스턴스 JsonEncodedText 를 만들 때 속성 이름은 이미 이스케이프되어야 합니다.

이 값은 쓰기 전에 이스케이프됩니다.

이 null경우 value 메서드가 호출된 것처럼 JSON null 값이 WriteNull(JsonEncodedText) 기록됩니다.

적용 대상

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

미리 인코딩된 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

utf8Value: ReadOnlySpan<Byte>

이름/값 쌍의 일부인 JSON 문자열로 작성될 UTF-8 인코딩 값입니다.

예외

ArgumentException

지정한 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

인스턴스 JsonEncodedText 를 만들 때 속성 이름을 이미 이스케이프해야 합니다.

이 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(JsonEncodedText, Guid)

미리 인코딩된 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, Guid value);

member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: Guid

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

Guid 기본값 StandardFormat (즉, 'D')을 nnnnn-nn-nnnn-nnnn-nn-nnn 형식으로 씁니다.

인스턴스 JsonEncodedText 를 만들 때 속성 이름을 이미 이스케이프해야 합니다.

적용 대상

WriteString(JsonEncodedText, DateTimeOffset)

미리 인코딩된 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: DateTimeOffset

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

DateTimeOffset ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000-07:00).

인스턴스 JsonEncodedText 를 만들 때 속성 이름을 이미 이스케이프해야 합니다.

적용 대상

WriteString(JsonEncodedText, DateTime)

미리 인코딩된 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTime value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)

매개 변수

propertyName: JsonEncodedText

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: DateTime

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

DateTime ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000).

인스턴스 JsonEncodedText 를 만들 때 속성 이름을 이미 이스케이프해야 합니다.

적용 대상

WriteString(String, JsonEncodedText)

속성 이름 및 미리 인코딩된값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (string propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : string * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As String, value As JsonEncodedText)

매개 변수

propertyName: String

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 속성 이름입니다.

value: JsonEncodedText

이름/값 쌍의 일부로서 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

인스턴스 JsonEncodedText 를 만들 때 값이 이미 이스케이프되어야 합니다.

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(String, String)

문자열로 지정한 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);

public void WriteString (string propertyName, string? value);

public void WriteString (string propertyName, string value);

member this.WriteString : string * string -> unit

Public Sub WriteString (propertyName As String, value As String)

매개 변수

propertyName: String

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: String

이름/값 쌍의 일부인 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

이 null경우 value 메서드가 호출된 것처럼 JSON null 값이 WriteNull(String) 작성됩니다.

적용 대상

WriteString(String, ReadOnlySpan<Char>)

문자열로 지정한 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);

public void WriteString (string propertyName, ReadOnlySpan<char> value);

member this.WriteString : string * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))

매개 변수

propertyName: String

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: ReadOnlySpan<Char>

이름/값 쌍의 일부인 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(String, ReadOnlySpan<Byte>)

문자열로 지정한 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (string propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : string * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))

매개 변수

propertyName: String

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

utf8Value: ReadOnlySpan<Byte>

이름/값 쌍의 일부인 JSON 문자열로 작성될 UTF-8 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(String, DateTimeOffset)

문자열로 지정한 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, DateTimeOffset value);

public void WriteString (string propertyName, DateTimeOffset value);

member this.WriteString : string * DateTimeOffset -> unit

Public Sub WriteString (propertyName As String, value As DateTimeOffset)

매개 변수

propertyName: String

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: DateTimeOffset

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

DateTimeOffset ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000-07:00).

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(String, DateTime)

문자열로 지정한 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, DateTime value);

public void WriteString (string propertyName, DateTime value);

member this.WriteString : string * DateTime -> unit

Public Sub WriteString (propertyName As String, value As DateTime)

매개 변수

propertyName: String

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: DateTime

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

DateTime ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000).

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(String, Guid)

문자열로 지정한 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(System::String ^ propertyName, Guid value);

public void WriteString (string propertyName, Guid value);

member this.WriteString : string * Guid -> unit

Public Sub WriteString (propertyName As String, value As Guid)

매개 변수

propertyName: String

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: Guid

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

ArgumentNullException

propertyName 매개 변수가 null인 경우

설명

Guid 기본값 StandardFormat (즉, 'D')을 nnnnn-nn-nnnn-nnnn-nn-nnn 형식으로 씁니다. 속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, String)

UTF-16 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<char> propertyName, string? value);

public void WriteString (ReadOnlySpan<char> propertyName, string value);

member this.WriteString : ReadOnlySpan<char> * string -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: String

이름/값 쌍의 일부인 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

이 null경우 value 메서드가 호출된 것처럼 JSON null 값이 WriteNull(ReadOnlySpan<Char>) 작성됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, DateTime)

UTF-8 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTime value);

member this.WriteString : ReadOnlySpan<byte> * DateTime -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

value: DateTime

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

DateTime ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000).

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

UTF-8 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

value: DateTimeOffset

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

DateTimeOffset ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000-07:00).

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

속성 이름 및 미리 인코딩된값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8로 트랜스코딩되고 작성될 JSON 개체의 속성 이름입니다.

value: JsonEncodedText

이름/값 쌍의 일부로서 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

인스턴스 JsonEncodedText 를 만들 때 값이 이미 이스케이프되어야 합니다.

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

UTF-8 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

utf8Value: ReadOnlySpan<Byte>

이름/값 쌍의 일부인 JSON 문자열로 작성될 UTF-8 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

UTF-8 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

value: ReadOnlySpan<Char>

이름/값 쌍의 일부인 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, String)

UTF-8 속성 이름 및 문자열 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string? value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string value);

member this.WriteString : ReadOnlySpan<byte> * string -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

value: String

이름/값 쌍의 일부인 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

이 null경우 value 메서드가 호출된 것처럼 JSON null 값이 WriteNull(ReadOnlySpan<Byte>) 작성됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, Guid)

UTF-8 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, Guid value);

member this.WriteString : ReadOnlySpan<byte> * Guid -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

value: Guid

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

Guid 기본값 StandardFormat (즉, 'D')을 nnnnn-nn-nnnn-nnnn-nn-nnn 형식으로 씁니다. 속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, DateTime)

읽기 전용 문자 범위로 지정한 속성 이름 및 DateTime 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTime value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTime value);

member this.WriteString : ReadOnlySpan<char> * DateTime -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: DateTime

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

DateTime ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000).

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

읽기 전용 문자 범위로 지정한 속성 이름 및 DateTimeOffset 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: DateTimeOffset

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

DateTimeOffset ISO 8601-1 확장 형식(System.Text.Json의 DateTime 및 DateTimeOffset 지원 참조)을 사용하여 작성합니다(예: 2017-06-12T05:30:45.7680000-07:00).

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, Guid)

읽기 전용 문자 범위로 지정한 속성 이름 및 Guid 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, Guid value);

public void WriteString (ReadOnlySpan<char> propertyName, Guid value);

member this.WriteString : ReadOnlySpan<char> * Guid -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: Guid

이름/값 쌍의 일부인 JSON 문자열로 작성될 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

Guid 기본값 StandardFormat (즉, 'D')을 nnnnn-nn-nnnn-nnnn-nn-nnn 형식으로 씁니다. 속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

UTF-16 속성 이름 및 UTF-8 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

utf8Value: ReadOnlySpan<Byte>

이름/값 쌍의 일부인 JSON 문자열로 작성될 UTF-8 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

UTF-16 속성 이름 및 UTF-16 텍스트 값(JSON 문자열)을 JSON 개체의 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))

매개 변수

propertyName: ReadOnlySpan<Char>

UTF-8으로 트랜스코딩되고 작성될 JSON 개체의 UTF-16 인코딩 속성 이름입니다.

value: ReadOnlySpan<Char>

이름/값 쌍의 일부인 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름 또는 값이 너무 큽니다.

InvalidOperationException

유효성 검사가 활성화되고, 쓰기 작업에서 잘못된 JSON을 생성합니다.

설명

속성 이름과 값은 쓰기 전에 이스케이프됩니다.

적용 대상

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

UTF-8 속성 이름 및 미리 인코딩된 값(JSON 문자열)을 JSON 개체 이름/값 쌍의 일부로 작성합니다.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)

매개 변수

utf8PropertyName: ReadOnlySpan<Byte>

작성될 JSON 개체의 UTF-8 인코딩 속성 이름입니다.

value: JsonEncodedText

이름/값 쌍의 일부로서 UTF-8 인코딩 JSON 문자열로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 속성 이름이 너무 큽니다.

InvalidOperationException

유효성 검사가 사용되며, 이 메서드를 사용하면 잘못된 JSON이 작성됩니다.

설명

인스턴스 JsonEncodedText 를 만들 때 값이 이미 이스케이프되어야 합니다.

속성 이름은 쓰기 전에 이스케이프됩니다.

적용 대상

다음을 통해 공유

Utf8JsonWriter.WriteString 메서드

정의

오버로드

WriteString(JsonEncodedText, JsonEncodedText)

매개 변수

예외

설명

적용 대상

WriteString(JsonEncodedText, String)

매개 변수

예외

설명

적용 대상

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

매개 변수

예외

설명

적용 대상

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

매개 변수

예외

설명

적용 대상

WriteString(JsonEncodedText, Guid)

매개 변수

예외

설명

적용 대상

WriteString(JsonEncodedText, DateTimeOffset)

매개 변수

예외

설명

적용 대상

WriteString(JsonEncodedText, DateTime)

매개 변수

예외

설명

적용 대상

WriteString(String, JsonEncodedText)

매개 변수

예외

설명

적용 대상

WriteString(String, String)

매개 변수

예외

설명

적용 대상

WriteString(String, ReadOnlySpan<Char>)

매개 변수

예외

설명

적용 대상

WriteString(String, ReadOnlySpan<Byte>)

매개 변수

예외

설명

적용 대상

WriteString(String, DateTimeOffset)

매개 변수

예외

설명

적용 대상

WriteString(String, DateTime)

매개 변수

예외

설명

적용 대상

WriteString(String, Guid)

매개 변수

예외

설명

적용 대상

WriteString(ReadOnlySpan<Char>, String)

매개 변수

예외

설명

적용 대상

WriteString(ReadOnlySpan<Byte>, DateTime)