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