Utf8JsonWriter.WriteStringValue メソッド

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

オーバーロード

WriteStringValue(String)	JSON 配列の要素として、文字列テキスト値 (JSON 文字列) を書き込みます。
WriteStringValue(DateTime)	JSON 配列の要素として、DateTime 値 (JSON 文字列として) を書き込みます。
WriteStringValue(DateTimeOffset)	JSON 配列の要素として、DateTimeOffset 値 (JSON 文字列として) を書き込みます。
WriteStringValue(Guid)	JSON 配列の要素として、Guid 値 (JSON 文字列として) を書き込みます。
WriteStringValue(ReadOnlySpan<Byte>)	JSON 配列の要素として、UTF-8 テキスト値 (JSON 文字列) を書き込みます。
WriteStringValue(ReadOnlySpan<Char>)	JSON 配列の要素として、UTF-16 テキスト値 (JSON 文字列) を書き込みます。
WriteStringValue(JsonEncodedText)	JSON 配列の要素として、事前にエンコードされたテキスト値 (JSON 文字列) を書き込みます。

WriteStringValue(String)

ソース:

Utf8JsonWriter.WriteValues.String.cs

JSON 配列の要素として、文字列テキスト値 (JSON 文字列) を書き込みます。

public:
 void WriteStringValue(System::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 が生成される場合があります。

注釈

値は書き込み前にエスケープされます。

が の場合value、 メソッドが呼び出されたかのようにWriteNullValue()、JSON の null 値が書き込まれます。null

WriteStringValue(DateTime)

ソース:

Utf8JsonWriter.WriteValues.DateTime.cs

JSON 配列の要素として、DateTime 値 (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 拡張形式を使用して を書き込みます DateTime ( たとえば、2017-06-12T05:30:45.7680000)。

WriteStringValue(DateTimeOffset)

ソース:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

JSON 配列の要素として、DateTimeOffset 値 (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 拡張形式を使用して を書き込みます DateTimeOffset ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000-07:00 です。

WriteStringValue(Guid)

ソース:

Utf8JsonWriter.WriteValues.Guid.cs

JSON 配列の要素として、Guid 値 (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') を使用して値を nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn という形式で書き込みますGuid。

WriteStringValue(ReadOnlySpan<Byte>)

ソース:

Utf8JsonWriter.WriteValues.String.cs

JSON 配列の要素として、UTF-8 テキスト値 (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>)

ソース:

Utf8JsonWriter.WriteValues.String.cs

JSON 配列の要素として、UTF-16 テキスト値 (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)

ソース:

Utf8JsonWriter.WriteValues.String.cs

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 が作成されたときに、値は既にエスケープされている必要があります。