Utf8JsonWriter.WriteString 方法

参考

定义

命名空间:: System.Text.Json

程序集:: System.Text.Json.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

WriteString(JsonEncodedText, JsonEncodedText)	将预编码的属性名称和预编码的文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(JsonEncodedText, String)	将预编码的属性名称和字符串文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	将预编码的属性名称和文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	将预编码的属性名称和 UTF-8 文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(JsonEncodedText, Guid)	将预编码的属性名称和 Guid 值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(JsonEncodedText, DateTimeOffset)	将预编码的属性名称和 DateTimeOffset 值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(JsonEncodedText, DateTime)	将预编码的属性名称和 DateTime 值（作为 JSON 字符串）写入 JSON 对象的名称/值对。
WriteString(String, JsonEncodedText)	将属性名称和预编码值（作为 JSON 字符串）写入 JSON 对象的名称/值对分。
WriteString(String, String)	编写指定为字符串的属性名称和字符串文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(String, ReadOnlySpan<Char>)	编写指定为字符串的属性名称和 UTF-16 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(String, ReadOnlySpan<Byte>)	编写指定为字符串的属性名称和 UTF-8 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(String, DateTimeOffset)	编写指定为字符串的属性名称和 DateTimeOffset 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(String, DateTime)	编写指定为字符串的属性名称和 DateTime 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(String, Guid)	编写指定为字符串的属性名称和 Guid 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, String)	编写 UTF-16 属性名称和字符串文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Byte>, DateTime)	编写 UTF-8 属性名称和 DateTime 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	编写 UTF-8 属性名称和 DateTimeOffset 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	将属性名称和预编码值（作为 JSON 字符串）写入 JSON 对象的名称/值对分。
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	编写 UTF-8 属性名称和 UTF-8 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	编写 UTF-8 属性名称和 UTF-16 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Byte>, String)	编写 UTF-8 属性名称和字符串文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Byte>, Guid)	编写 UTF-8 属性名称和 Guid 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, DateTime)	编写指定为只读字符范围的属性名称和 DateTime 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	编写指定为只读字符范围的属性名称和 DateTimeOffset 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, Guid)	编写指定为只读字符范围的属性名称和 Guid 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	编写 UTF-16 属性名称和 UTF-8 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	编写 UTF-16 属性名称和 UTF-16 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	将 UTF-8 属性名称和预编码值（作为 JSON 字符串）写入 JSON 对象的名称/值对分。

WriteString(JsonEncodedText, JsonEncodedText)

将预编码的属性名称和预编码的文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

value: JsonEncodedText

要以 UTF-8 转码的 JSON 字符串形式写入名称/值对的 JSON 编码值。

例外

InvalidOperationException

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

注解

创建实例 JsonEncodedText 时，应已转义属性名称和值。

适用于

WriteString(JsonEncodedText, String)

将预编码的属性名称和字符串文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string? value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string value);

member this.WriteString : System.Text.Json.JsonEncodedText * string -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As String)

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

value: String

要作为 UTF-8 转码的 JSON 字符串写入名称/值对的值。

例外

ArgumentException

指定的值太大。

InvalidOperationException

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

注解

创建实例 JsonEncodedText 时，应已转义属性名称。

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

如果是value，则写入 JSON null 值，就像调用方法一WriteNull(JsonEncodedText)null样。

适用于

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

将预编码的属性名称和文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

value: ReadOnlySpan<Char>

要作为 UTF-8 转码的 JSON 字符串写入名称/值对的值。

例外

ArgumentException

指定的值太大。

InvalidOperationException

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

注解

创建实例 JsonEncodedText 时，应已转义属性名称。

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

如果是value，则写入 JSON null 值，就像调用方法一WriteNull(JsonEncodedText)null样。

适用于

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

将预编码的属性名称和 UTF-8 文本值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

utf8Value: ReadOnlySpan<Byte>

要以 JSON 字符串形式作为名称/值对的一部分编写的 UTF-8 编码值。

例外

ArgumentException

指定的值太大。

InvalidOperationException

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

注解

创建实例 JsonEncodedText 时，应已转义属性名称。

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

适用于

WriteString(JsonEncodedText, Guid)

将预编码的属性名称和 Guid 值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, Guid value);

member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

value: Guid

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

InvalidOperationException

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

注解

Guid以 nnnnnn-nnnn-nn 为格式的默认StandardFormat (写入“D”) 。

创建实例 JsonEncodedText 时，应已转义属性名称。

适用于

WriteString(JsonEncodedText, DateTimeOffset)

将预编码的属性名称和 DateTimeOffset 值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

value: DateTimeOffset

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

InvalidOperationException

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

注解

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

创建实例 JsonEncodedText 时，应已转义属性名称。

适用于

WriteString(JsonEncodedText, DateTime)

将预编码的属性名称和 DateTime 值（作为 JSON 字符串）写入 JSON 对象的名称/值对。

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTime value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)

参数

propertyName: JsonEncodedText

要进行转码并写为 UTF-8 的 JSON 对象的 JSON 编码属性名称。

value: DateTime

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

InvalidOperationException

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

注解

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

创建实例 JsonEncodedText 时，应已转义属性名称。

适用于

WriteString(String, JsonEncodedText)

将属性名称和预编码值（作为 JSON 字符串）写入 JSON 对象的名称/值对分。

public:
 void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (string propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : string * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As String, value As JsonEncodedText)

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的属性名称。

value: JsonEncodedText

要以 UTF-8 转码的 JSON 字符串形式写入名称/值对的 JSON 编码值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

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

在写入之前，属性名称将转义。

适用于

WriteString(String, String)

编写指定为字符串的属性名称和字符串文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);

public void WriteString (string propertyName, string? value);

public void WriteString (string propertyName, string value);

member this.WriteString : string * string -> unit

Public Sub WriteString (propertyName As String, value As String)

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: String

要以 UTF-8 转码的 JSON 字符串形式作为名称/值对的一部分编写的 UTF-16 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

在写入之前，属性名称和值将转义。

如果是value，则写入 JSON null 值，就像调用方法一WriteNull(String)null样。

适用于

WriteString(String, ReadOnlySpan<Char>)

编写指定为字符串的属性名称和 UTF-16 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);

public void WriteString (string propertyName, ReadOnlySpan<char> value);

member this.WriteString : string * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: ReadOnlySpan<Char>

要以 UTF-8 转码的 JSON 字符串形式作为名称/值对的一部分编写的 UTF-16 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

在写入之前，属性名称和值将转义。

适用于

WriteString(String, ReadOnlySpan<Byte>)

编写指定为字符串的属性名称和 UTF-8 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (string propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : string * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

utf8Value: ReadOnlySpan<Byte>

要以 JSON 字符串形式作为名称/值对的一部分编写的 UTF-8 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

在写入之前，属性名称和值将转义。

适用于

WriteString(String, DateTimeOffset)

编写指定为字符串的属性名称和 DateTimeOffset 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(System::String ^ propertyName, DateTimeOffset value);

public void WriteString (string propertyName, DateTimeOffset value);

member this.WriteString : string * DateTimeOffset -> unit

Public Sub WriteString (propertyName As String, value As DateTimeOffset)

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: DateTimeOffset

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

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

在写入之前，属性名称将转义。

适用于

WriteString(String, DateTime)

编写指定为字符串的属性名称和 DateTime 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(System::String ^ propertyName, DateTime value);

public void WriteString (string propertyName, DateTime value);

member this.WriteString : string * DateTime -> unit

Public Sub WriteString (propertyName As String, value As DateTime)

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: DateTime

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

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

在写入之前，属性名称将转义。

适用于

WriteString(String, Guid)

编写指定为字符串的属性名称和 Guid 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(System::String ^ propertyName, Guid value);

public void WriteString (string propertyName, Guid value);

member this.WriteString : string * Guid -> unit

Public Sub WriteString (propertyName As String, value As Guid)

参数

propertyName: String

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: Guid

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

ArgumentNullException

propertyName 参数为 null。

注解

Guid以 nnnnnn-nnnn-nn 为格式的默认StandardFormat (写入“D”) 。在写入之前，属性名称将转义。

适用于

WriteString(ReadOnlySpan<Char>, String)

编写 UTF-16 属性名称和字符串文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<char> propertyName, string? value);

public void WriteString (ReadOnlySpan<char> propertyName, string value);

member this.WriteString : ReadOnlySpan<char> * string -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: String

要以 UTF-8 转码的 JSON 字符串形式作为名称/值对的一部分编写的 UTF-16 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

注解

在写入之前，属性名称和值将转义。

如果是value，则写入 JSON null 值，就像调用方法一WriteNull(ReadOnlySpan<Char>)null样。

适用于

WriteString(ReadOnlySpan<Byte>, DateTime)

编写 UTF-8 属性名称和 DateTime 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTime value);

member this.WriteString : ReadOnlySpan<byte> * DateTime -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

value: DateTime

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

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

属性名称在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

编写 UTF-8 属性名称和 DateTimeOffset 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

value: DateTimeOffset

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

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

属性名称在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

将属性名称和预编码值（作为 JSON 字符串）写入 JSON 对象的名称/值对分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的属性名称。

value: JsonEncodedText

要以 UTF-8 转码的 JSON 字符串形式写入名称/值对的 JSON 编码值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

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

在写入之前，属性名称将转义。

适用于

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

编写 UTF-8 属性名称和 UTF-8 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

utf8Value: ReadOnlySpan<Byte>

要以 JSON 字符串形式作为名称/值对的一部分编写的 UTF-8 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

注解

属性名称和值在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

编写 UTF-8 属性名称和 UTF-16 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

value: ReadOnlySpan<Char>

要以 UTF-8 转码的 JSON 字符串形式作为名称/值对的一部分编写的 UTF-16 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

注解

属性名称和值在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Byte>, String)

编写 UTF-8 属性名称和字符串文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string? value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string value);

member this.WriteString : ReadOnlySpan<byte> * string -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

value: String

要以 UTF-8 转码的 JSON 字符串形式作为名称/值对的一部分编写的 UTF-16 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

注解

属性名称和值在写入之前进行转义。

如果是value，则写入 JSON null 值，就像调用方法一WriteNull(ReadOnlySpan<Byte>)null样。

适用于

WriteString(ReadOnlySpan<Byte>, Guid)

编写 UTF-8 属性名称和 Guid 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, Guid value);

member this.WriteString : ReadOnlySpan<byte> * Guid -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

value: Guid

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

Guid以 nnnn-nn 形式写入使用默认StandardFormat (（即“D”) ）。属性名称在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Char>, DateTime)

编写指定为只读字符范围的属性名称和 DateTime 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTime value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTime value);

member this.WriteString : ReadOnlySpan<char> * DateTime -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: DateTime

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

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

属性名称在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

编写指定为只读字符范围的属性名称和 DateTimeOffset 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: DateTimeOffset

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

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

属性名称在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Char>, Guid)

编写指定为只读字符范围的属性名称和 Guid 值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, Guid value);

public void WriteString (ReadOnlySpan<char> propertyName, Guid value);

member this.WriteString : ReadOnlySpan<char> * Guid -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: Guid

要以 JSON 字符串形式作为名称/值对的一部分编写的值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

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

注解

Guid以 nnnn-nn 形式写入使用默认StandardFormat (（即“D”) ）。属性名称在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

编写 UTF-16 属性名称和 UTF-8 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

utf8Value: ReadOnlySpan<Byte>

要以 JSON 字符串形式作为名称/值对的一部分编写的 UTF-8 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

注解

属性名称和值在写入之前进行转义。

适用于

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

编写 UTF-16 属性名称和 UTF-16 文本值（写为 JSON 字符串）作为 JSON 对象的名称/值对的一部分。

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))

参数

propertyName: ReadOnlySpan<Char>

要进行转码并写为 UTF-8 的 JSON 对象的 UTF-16 编码属性名称。

value: ReadOnlySpan<Char>

要以 UTF-8 转码的 JSON 字符串形式作为名称/值对的一部分编写的 UTF-16 编码值。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

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

注解

在写入之前，属性名称和值将转义。

适用于

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

将 UTF-8 属性名称和预编码值（作为 JSON 字符串）写入 JSON 对象的名称/值对分。

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)

参数

utf8PropertyName: ReadOnlySpan<Byte>

要编写的 JSON 对象的 UTF-8 编码属性名称。

value: JsonEncodedText

要以 UTF-8 转码的 JSON 字符串形式写入名称/值对的 JSON 编码值。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

系统已启用验证，此方法将导致编写无效的 JSON。

注解

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

属性名称在写入之前进行转义。

适用于