Utf8JsonWriter.WriteStringValue 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

System.Text.Json v9.0.0-preview.3.24172.9

重载

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)

Source:

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 为 null，则写入 JSON null 值，就像 WriteNullValue() 调用 方法一样。

WriteStringValue(DateTime)

Source:

Utf8JsonWriter.WriteValues.DateTime.cs

编写 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 数组的元素编写的值。

例外

InvalidOperationException

系统已启用验证，该操作将导致编写无效的 JSON。

注解

此方法使用 ISO 8601-1 扩展格式编写 DateTime (请参阅 System.Text.Json) 中的 DateTime 和 DateTimeOffset 支持 ;例如，2017-06-12T05：30：45.7680000。

WriteStringValue(DateTimeOffset)

Source:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

编写 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 数组的元素编写的值。

例外

InvalidOperationException

系统已启用验证，该操作将导致编写无效的 JSON。

注解

此方法使用 ISO 8601-1 扩展格式编写 DateTimeOffset ， (请参阅 System.Text.Json) 中的 DateTime 和 DateTimeOffset 支持 ;例如，2017-06-12T05：30：45.7680000-07：00。

WriteStringValue(Guid)

Source:

Utf8JsonWriter.WriteValues.Guid.cs

编写 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 数组的元素编写的值。

例外

InvalidOperationException

系统已启用验证，该操作将导致编写无效的 JSON。

注解

此方法使用默认StandardFormat (（即“D”) ）写入Guid值，格式为：nnnnnn-nnnn-nnnn-nn。

WriteStringValue(ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteValues.String.cs

编写 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 编码值。

例外

ArgumentException

指定的值太大。

InvalidOperationException

系统已启用验证，该编写操作将生成无效的 JSON。

注解

该值在写入之前进行转义。

WriteStringValue(ReadOnlySpan<Char>)

Source:

Utf8JsonWriter.WriteValues.String.cs

编写 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 编码值。

例外

ArgumentException

指定的值太大。

InvalidOperationException

系统已启用验证，该编写操作将生成无效的 JSON。

注解

该值在写入之前进行转义。

WriteStringValue(JsonEncodedText)

Source:

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 时，值应已转义。