Utf8JsonWriter.WriteString メソッド

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

オーバーロード

WriteString(JsonEncodedText, JsonEncodedText)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と事前にエンコードされた値 (JSON 文字列) を書き込みます。
WriteString(JsonEncodedText, String)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と文字列テキスト値 (JSON 文字列) を書き込みます。
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名とテキスト値 (JSON 文字列) を書き込みます。
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と UTF-8 テキスト値 (JSON 文字列) を書き込みます。
WriteString(JsonEncodedText, Guid)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と Guid 値 (JSON 文字列) を書き込みます。
WriteString(JsonEncodedText, DateTimeOffset)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と DateTimeOffset 値 (JSON 文字列) を書き込みます。
WriteString(JsonEncodedText, DateTime)	JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と DateTime 値 (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)	JSON オブジェクトの名前/値ペアの一部として、UTF-16 プロパティ名と文字列テキスト値 (JSON 文字列として) を書き込みます。
WriteString(ReadOnlySpan<Byte>, DateTime)	JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と DateTime 値 (JSON 文字列として) を書き込みます。
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と DateTimeOffset 値 (JSON 文字列として) を書き込みます。
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	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<Byte>, Guid)	JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と Guid 値 (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>)	JSON オブジェクトの名前/値ペアの一部として、UTF-16 プロパティ名と UTF-8 テキスト値 (JSON 文字列として) を書き込みます。
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	JSON オブジェクトの名前/値ペアの一部として、UTF-16 プロパティ名と UTF-16 テキスト値 (JSON 文字列として) を書き込みます。
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と事前にエンコードされた値 (JSON 文字列) を書き込みます。

WriteString(JsonEncodedText, JsonEncodedText)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

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 オブジェクトの JSON でエンコードされたプロパティ名。

value

JsonEncodedText

名前/値ペアの一部として、UTF-8 でトランスコードされた JSON 文字列として書き込まれる JSON でエンコードされた値。

例外

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

のインスタンス JsonEncodedText が作成されたときに、プロパティ名と値は既にエスケープされている必要があります。

WriteString(JsonEncodedText, String)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と文字列テキスト値 (JSON 文字列) を書き込みます。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::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 オブジェクトの JSON でエンコードされたプロパティ名。

value

String

名前/値ペアの一部として、UTF-8 でトランスコードされた JSON 文字列として書き込まれる値。

例外

ArgumentException

指定した値が大きすぎます。

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

のインスタンス JsonEncodedText が作成されたときに、プロパティ名は既にエスケープされている必要があります。

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

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 オブジェクトの JSON でエンコードされたプロパティ名。

value

ReadOnlySpan<Char>

名前/値ペアの一部として、UTF-8 でトランスコードされた JSON 文字列として書き込まれる値。

例外

ArgumentException

指定した値が大きすぎます。

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

のインスタンス JsonEncodedText が作成されたときに、プロパティ名は既にエスケープされている必要があります。

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と UTF-8 テキスト値 (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 オブジェクトの JSON でエンコードされたプロパティ名。

utf8Value

ReadOnlySpan<Byte>

名前/値ペアの一部として、JSON 文字列として書き込まれる UTF-8 でエンコードされた値。

例外

ArgumentException

指定した値が大きすぎます。

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

のインスタンス JsonEncodedText が作成されたときに、プロパティ名は既にエスケープされている必要があります。

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

WriteString(JsonEncodedText, Guid)

ソース:

Utf8JsonWriter.WriteProperties.Guid.cs

JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と Guid 値 (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 オブジェクトの JSON でエンコードされたプロパティ名。

value

Guid

名前/値ペアの一部として、JSON 文字列として書き込まれる値。

例外

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

Guid既定StandardFormatの (つまり、'D') を使用して、nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn という形式で を書き込みます。

のインスタンス JsonEncodedText が作成されたときに、プロパティ名は既にエスケープされている必要があります。

WriteString(JsonEncodedText, DateTimeOffset)

ソース:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と DateTimeOffset 値 (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 オブジェクトの JSON でエンコードされたプロパティ名。

value

DateTimeOffset

名前/値ペアの一部として、JSON 文字列として書き込まれる値。

例外

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

ISO 8601-1 拡張形式を使用して を DateTimeOffset 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000-07:00 です。

のインスタンス JsonEncodedText が作成されたときに、プロパティ名は既にエスケープされている必要があります。

WriteString(JsonEncodedText, DateTime)

ソース:

Utf8JsonWriter.WriteProperties.DateTime.cs

JSON オブジェクトの名前/値ペアの一部として、事前にエンコードされたプロパティ名と DateTime 値 (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 オブジェクトの JSON でエンコードされたプロパティ名。

value

DateTime

名前/値ペアの一部として、JSON 文字列として書き込まれる値。

例外

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

ISO 8601-1 拡張形式を使用して を DateTime 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000。

のインスタンス JsonEncodedText が作成されたときに、プロパティ名は既にエスケープされている必要があります。

WriteString(String, JsonEncodedText)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

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 文字列として書き込まれる JSON でエンコードされた値。

例外

ArgumentException

指定されたプロパティ名が長すぎます。

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

ArgumentNullException

propertyName パラメーターが null です。

注釈

のインスタンス JsonEncodedText が作成されたときに、値は既にエスケープされている必要があります。

プロパティ名は、書き込む前にエスケープされます。

WriteString(String, String)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

文字列として指定されたプロパティ名と、文字列テキスト値 (JSON 文字列として) を、JSON オブジェクトの名前/値ペアの一部として書き込みます。

public:
 void WriteString(System::String ^ propertyName, System::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>)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

文字列として指定されたプロパティ名と、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>)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

文字列として指定されたプロパティ名と、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)

ソース:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

文字列として指定されたプロパティ名と、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 です。

注釈

ISO 8601-1 拡張形式を使用して を DateTimeOffset 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000-07:00 です。

プロパティ名は、書き込む前にエスケープされます。

WriteString(String, DateTime)

ソース:

Utf8JsonWriter.WriteProperties.DateTime.cs

文字列として指定されたプロパティ名と、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 です。

注釈

ISO 8601-1 拡張形式を使用して を DateTime 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000。

プロパティ名は、書き込む前にエスケープされます。

WriteString(String, Guid)

ソース:

Utf8JsonWriter.WriteProperties.Guid.cs

文字列として指定されたプロパティ名と、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') を使用して、 を nnnnnnnn-nnnn-nnnn-nnnn-nnnn という形式で書き込みます。 プロパティ名は、書き込む前にエスケープされます。

WriteString(ReadOnlySpan<Char>, String)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-16 プロパティ名と文字列テキスト値 (JSON 文字列として) を書き込みます。

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::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)

ソース:

Utf8JsonWriter.WriteProperties.DateTime.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と DateTime 値 (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 が生成される場合があります。

注釈

ISO 8601-1 拡張形式を使用して を DateTime 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000。

プロパティ名は、書き込む前にエスケープされます。

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

ソース:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と DateTimeOffset 値 (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 が生成される場合があります。

注釈

ISO 8601-1 拡張形式を使用して を DateTimeOffset 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000-07:00 です。

プロパティ名は、書き込む前にエスケープされます。

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

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 文字列として書き込まれる JSON でエンコードされた値。

例外

ArgumentException

指定されたプロパティ名が長すぎます。

InvalidOperationException

検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。

注釈

のインスタンス JsonEncodedText が作成されたときに、値は既にエスケープされている必要があります。

プロパティ名は、書き込む前にエスケープされます。

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

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と UTF-8 テキスト値 (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>)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と UTF-16 テキスト値 (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)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と文字列テキスト値 (JSON 文字列として) を書き込みます。

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

注釈

プロパティの名前と値は、書き込む前にエスケープされます。

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

WriteString(ReadOnlySpan<Byte>, Guid)

ソース:

Utf8JsonWriter.WriteProperties.Guid.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と Guid 値 (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') を使用して、nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn という形式で を書き込みます。 プロパティ名は、書き込む前にエスケープされます。

WriteString(ReadOnlySpan<Char>, DateTime)

ソース:

Utf8JsonWriter.WriteProperties.DateTime.cs

読み取り専用の文字範囲として指定されたプロパティ名と、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 が生成される場合があります。

注釈

ISO 8601-1 拡張形式を使用して を DateTime 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000。

プロパティ名は、書き込む前にエスケープされます。

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

ソース:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

読み取り専用の文字範囲として指定されたプロパティ名と、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 が生成される場合があります。

注釈

ISO 8601-1 拡張形式を使用して を DateTimeOffset 書き込みます ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000-07:00 です。

プロパティ名は、書き込む前にエスケープされます。

WriteString(ReadOnlySpan<Char>, Guid)

ソース:

Utf8JsonWriter.WriteProperties.Guid.cs

読み取り専用の文字範囲として指定されたプロパティ名と、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') を使用して、nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn という形式で を書き込みます。 プロパティ名は、書き込む前にエスケープされます。

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

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-16 プロパティ名と UTF-8 テキスト値 (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>)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-16 プロパティ名と UTF-16 テキスト値 (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)

ソース:

Utf8JsonWriter.WriteProperties.String.cs

JSON オブジェクトの名前/値ペアの一部として、UTF-8 プロパティ名と事前にエンコードされた値 (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 文字列として書き込まれる JSON でエンコードされた値。

例外

ArgumentException

指定されたプロパティ名が長すぎます。

InvalidOperationException

検証が有効化されると、このメソッドによって無効な JSON の書き込みが行われる場合があります。

注釈

のインスタンス JsonEncodedText が作成されたときに、値は既にエスケープされている必要があります。

プロパティ名は、書き込む前にエスケープされます。