Utf8JsonWriter.WriteStringValue 方法

定义

重载

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
Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs

编写字符串文本值(写为 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。

注解

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

如果 valuenull,则写入 JSON null 值,就像 WriteNullValue() 调用 方法一样。

适用于

WriteStringValue(DateTime)

Source:
Utf8JsonWriter.WriteValues.DateTime.cs
Source:
Utf8JsonWriter.WriteValues.DateTime.cs
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 数组的元素编写的值。

例外

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

注解

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

适用于

WriteStringValue(DateTimeOffset)

Source:
Utf8JsonWriter.WriteValues.DateTimeOffset.cs
Source:
Utf8JsonWriter.WriteValues.DateTimeOffset.cs
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 数组的元素编写的值。

例外

系统已启用验证,该操作将导致编写无效的 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
Source:
Utf8JsonWriter.WriteValues.Guid.cs
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 数组的元素编写的值。

例外

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

注解

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

适用于

WriteStringValue(ReadOnlySpan<Byte>)

Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs
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 编码值。

例外

指定的值太大。

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

注解

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

适用于

WriteStringValue(ReadOnlySpan<Char>)

Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs
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 编码值。

例外

指定的值太大。

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

注解

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

适用于

WriteStringValue(JsonEncodedText)

Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs
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 编码值。

例外

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

注解

创建 实例 JsonEncodedText 时,值应已转义。

适用于