Utf8JsonWriter.WriteStringValue 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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 编码值。
例外
指定的值太大。
系统已启用验证,该编写操作将生成无效的 JSON。
注解
该值在写入之前进行转义。
如果 value
为 null
,则写入 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 数组的元素编写的值。
例外
系统已启用验证,该操作将导致编写无效的 JSON。
注解
此方法使用 ISO 8601-1 扩展格式编写 DateTime (请参阅 System.Text.Json) 中的 DateTime 和 DateTimeOffset 支持 ;例如,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 数组的元素编写的值。
例外
系统已启用验证,该操作将导致编写无效的 JSON。
注解
此方法使用 ISO 8601-1 扩展格式编写 DateTimeOffset , (请参阅 System.Text.Json) 中的 DateTime 和 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 数组的元素编写的值。
例外
系统已启用验证,该操作将导致编写无效的 JSON。
注解
此方法使用默认StandardFormat ((即“D”) )写入Guid值,格式为:nnnnnn-nnnn-nnnn-nn。
适用于
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 编码值。
例外
指定的值太大。
系统已启用验证,该编写操作将生成无效的 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 编码值。
例外
指定的值太大。
系统已启用验证,该编写操作将生成无效的 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 编码值。
例外
系统已启用验证,该编写操作将生成无效的 JSON。
注解
创建 实例 JsonEncodedText 时,值应已转义。