Utf8JsonWriter.WriteStringValue 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

重载

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