Utf8JsonWriter.WriteStringValue メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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)
JSON 配列の要素として、文字列テキスト値 (JSON 文字列) を書き込みます。
public:
void WriteStringValue(System::String ^ value);public void WriteStringValue (string? value);public void WriteStringValue (string value);member this.WriteStringValue : string -> unitPublic Sub WriteStringValue (value As String)パラメーター
- value
- String
JSON 配列の UTF-8 でトランスコードされた JSON 文字列要素として書き込まれる UTF-16 でエンコードされた値。
例外
指定した値が大きすぎます。
検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。
注釈
値は書き込み前にエスケープされます。
が の場合value、 メソッドが呼び出されたかのようにWriteNullValue()、JSON の null 値が書き込まれます。null
適用対象
WriteStringValue(DateTime)
JSON 配列の要素として、DateTime 値 (JSON 文字列として) を書き込みます。
public:
void WriteStringValue(DateTime value);public void WriteStringValue (DateTime value);member this.WriteStringValue : DateTime -> unitPublic Sub WriteStringValue (value As DateTime)パラメーター
- value
- DateTime
JSON 配列の一部として、JSON 文字列として書き込まれる値。
例外
検証が有効化されると、操作によって無効な JSON の書き込みが行われる場合があります。
注釈
このメソッドは、ISO 8601-1 拡張形式を使用して を書き込みます DateTime ( たとえば、2017-06-12T05:30:45.7680000)。
適用対象
WriteStringValue(DateTimeOffset)
JSON 配列の要素として、DateTimeOffset 値 (JSON 文字列として) を書き込みます。
public:
void WriteStringValue(DateTimeOffset value);public void WriteStringValue (DateTimeOffset value);member this.WriteStringValue : DateTimeOffset -> unitPublic Sub WriteStringValue (value As DateTimeOffset)パラメーター
- value
- DateTimeOffset
JSON 配列の一部として、JSON 文字列として書き込まれる値。
例外
検証が有効化されると、操作によって無効な JSON の書き込みが行われる場合があります。
注釈
このメソッドは、ISO 8601-1 拡張形式を使用して を書き込みます DateTimeOffset ( 「System.Text.Json での DateTime と DateTimeOffset のサポート」を参照してください)。たとえば、2017-06-12T05:30:45.7680000-07:00 です。
適用対象
WriteStringValue(Guid)
JSON 配列の要素として、Guid 値 (JSON 文字列として) を書き込みます。
public:
void WriteStringValue(Guid value);public void WriteStringValue (Guid value);member this.WriteStringValue : Guid -> unitPublic Sub WriteStringValue (value As Guid)パラメーター
- value
- Guid
JSON 配列の一部として、JSON 文字列として書き込まれる値。
例外
検証が有効化されると、操作によって無効な JSON の書き込みが行われる場合があります。
注釈
このメソッドは、既定値 StandardFormat (つまり 'D') を使用して値を nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn という形式で書き込みますGuid。
適用対象
WriteStringValue(ReadOnlySpan<Byte>)
JSON 配列の要素として、UTF-8 テキスト値 (JSON 文字列) を書き込みます。
public:
void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);public void WriteStringValue (ReadOnlySpan<byte> utf8Value);member this.WriteStringValue : ReadOnlySpan<byte> -> unitPublic Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))パラメーター
- utf8Value
- ReadOnlySpan<Byte>
JSON 配列の JSON 文字列要素として書き込まれる UTF-8 でエンコードされた値。
例外
指定した値が大きすぎます。
検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。
注釈
値は書き込み前にエスケープされます。
適用対象
WriteStringValue(ReadOnlySpan<Char>)
JSON 配列の要素として、UTF-16 テキスト値 (JSON 文字列) を書き込みます。
public:
void WriteStringValue(ReadOnlySpan<char> value);public void WriteStringValue (ReadOnlySpan<char> value);member this.WriteStringValue : ReadOnlySpan<char> -> unitPublic Sub WriteStringValue (value As ReadOnlySpan(Of Char))パラメーター
- value
- ReadOnlySpan<Char>
JSON 配列の UTF-8 でトランスコードされた JSON 文字列要素として書き込まれる UTF-16 でエンコードされた値。
例外
指定した値が大きすぎます。
検証が有効化されると、書き込み操作によって無効な 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 -> unitPublic Sub WriteStringValue (value As JsonEncodedText)パラメーター
- value
- JsonEncodedText
JSON 配列の UTF-8 でトランスコードされた JSON 文字列要素として書き込まれる JSON でエンコードされた値。
例外
検証が有効化されると、書き込み操作によって無効な JSON が生成される場合があります。
注釈
のインスタンス JsonEncodedText が作成されたときに、値は既にエスケープされている必要があります。
適用対象
.NET