Utf8JsonWriter.WriteStringValue 메서드

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

오버로드

WriteStringValue(String)	문자열 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.
WriteStringValue(DateTime)	DateTime 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.
WriteStringValue(DateTimeOffset)	DateTimeOffset 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.
WriteStringValue(Guid)	Guid 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.
WriteStringValue(ReadOnlySpan<Byte>)	UTF-8 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.
WriteStringValue(ReadOnlySpan<Char>)	UTF-16 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.
WriteStringValue(JsonEncodedText)	미리 인코딩된 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

WriteStringValue(String)

문자열 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(System::String ^ value);

public void WriteStringValue (string? value);

public void WriteStringValue (string value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

매개 변수

value

String

JSON 배열의 UTF-8 트랜스코딩 JSON 문자열 요소로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 값이 너무 큽니다.

InvalidOperationException

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

설명

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

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

WriteStringValue(DateTime)

DateTime 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

매개 변수

value

DateTime

JSON 배열의 요소인 JSON 문자열로 작성될 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 작업을 수행하면 잘못된 JSON이 작성됩니다.

설명

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

WriteStringValue(DateTimeOffset)

DateTimeOffset 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

매개 변수

value

DateTimeOffset

JSON 배열의 요소인 JSON 문자열로 작성될 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 작업을 수행하면 잘못된 JSON이 작성됩니다.

설명

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

WriteStringValue(Guid)

Guid 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

매개 변수

value

Guid

JSON 배열의 요소인 JSON 문자열로 작성될 값입니다.

예외

InvalidOperationException

유효성 검사가 활성화되고, 작업을 수행하면 잘못된 JSON이 작성됩니다.

설명

이 메서드는 기본값 StandardFormat (즉, 'D')을 사용하여 nnnnnn-nn-nnnn-nnnn-nn-nnn 형식으로 값을 씁니다Guid.

WriteStringValue(ReadOnlySpan<Byte>)

UTF-8 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);

public void WriteStringValue (ReadOnlySpan<byte> utf8Value);

member this.WriteStringValue : ReadOnlySpan<byte> -> unit

Public Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))

매개 변수

utf8Value

ReadOnlySpan<Byte>

JSON 배열의 JSON 문자열 요소로 작성될 UTF-8 인코딩 값입니다.

예외

ArgumentException

지정한 값이 너무 큽니다.

InvalidOperationException

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

설명

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

WriteStringValue(ReadOnlySpan<Char>)

UTF-16 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(ReadOnlySpan<char> value);

public void WriteStringValue (ReadOnlySpan<char> value);

member this.WriteStringValue : ReadOnlySpan<char> -> unit

Public Sub WriteStringValue (value As ReadOnlySpan(Of Char))

매개 변수

value

ReadOnlySpan<Char>

JSON 배열의 UTF-8 트랜스코딩 JSON 문자열 요소로 작성될 UTF-16 인코딩 값입니다.

예외

ArgumentException

지정한 값이 너무 큽니다.

InvalidOperationException

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

설명

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

WriteStringValue(JsonEncodedText)

미리 인코딩된 텍스트 값(JSON 문자열)을 JSON 배열의 요소로 작성합니다.

public:
 void WriteStringValue(System::Text::Json::JsonEncodedText value);

public void WriteStringValue (System.Text.Json.JsonEncodedText value);

member this.WriteStringValue : System.Text.Json.JsonEncodedText -> unit

Public Sub WriteStringValue (value As JsonEncodedText)

매개 변수

value

JsonEncodedText

JSON 배열의 UTF-8 트랜스코딩 JSON 문자열 요소로 작성될 JSON 인코딩 값입니다.

예외

InvalidOperationException

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

설명

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