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

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

适用于

通过

Utf8JsonWriter.WriteString 方法

定义

重载

WriteString(JsonEncodedText, JsonEncodedText)

参数

例外

注解

适用于

WriteString(JsonEncodedText, String)

参数

例外

注解

适用于

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

参数

例外

注解

适用于

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

参数

例外

注解

适用于

WriteString(JsonEncodedText, Guid)

参数

例外

注解

适用于

WriteString(JsonEncodedText, DateTimeOffset)

参数

例外

注解

适用于

WriteString(JsonEncodedText, DateTime)

参数

例外

注解

适用于

WriteString(String, JsonEncodedText)

参数

例外

注解

适用于

WriteString(String, String)

参数

例外

注解

适用于

WriteString(String, ReadOnlySpan<Char>)

参数

例外

注解

适用于

WriteString(String, ReadOnlySpan<Byte>)

参数

例外

注解

适用于

WriteString(String, DateTimeOffset)

参数

例外

注解

适用于

WriteString(String, DateTime)

参数

例外

注解

适用于

WriteString(String, Guid)

参数

例外

注解

适用于

WriteString(ReadOnlySpan<Char>, String)

参数

例外

注解

适用于

WriteString(ReadOnlySpan<Byte>, DateTime)