Utf8JsonWriter.WriteStartArray 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

重载

WriteStartArray()	编写 JSON 数组的开头。
WriteStartArray(ReadOnlySpan<Byte>)	编写 JSON 数组的开头，将指定为字节只读范围的属性名称作为键。
WriteStartArray(ReadOnlySpan<Char>)	编写 JSON 数组的开头，将指定为只读字符范围的属性名称作为键。
WriteStartArray(String)	编写 JSON 数组的开头，将指定为字符串的属性名称作为键。
WriteStartArray(JsonEncodedText)	编写将预编码属性名称作为键的 JSON 数组的开头。

WriteStartArray()

编写 JSON 数组的开头。

public:
 void WriteStartArray();

public void WriteStartArray ();

member this.WriteStartArray : unit -> unit

Public Sub WriteStartArray ()

例外

InvalidOperationException

JSON 的深度超过最大深度 1,000。

• 或 -

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

WriteStartArray(ReadOnlySpan<Byte>)

编写 JSON 数组的开头，将指定为字节只读范围的属性名称作为键。

public:
 void WriteStartArray(ReadOnlySpan<System::Byte> utf8PropertyName);

public void WriteStartArray (ReadOnlySpan<byte> utf8PropertyName);

member this.WriteStartArray : ReadOnlySpan<byte> -> unit

Public Sub WriteStartArray (utf8PropertyName As ReadOnlySpan(Of Byte))

参数

utf8PropertyName

ReadOnlySpan<Byte>

要编写的 JSON 数组的 UTF-8 编码属性名称。

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

JSON 的深度超过最大深度 1,000。

• 或 -

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

注解

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

WriteStartArray(ReadOnlySpan<Char>)

编写 JSON 数组的开头，将指定为只读字符范围的属性名称作为键。

public:
 void WriteStartArray(ReadOnlySpan<char> propertyName);

public void WriteStartArray (ReadOnlySpan<char> propertyName);

member this.WriteStartArray : ReadOnlySpan<char> -> unit

Public Sub WriteStartArray (propertyName As ReadOnlySpan(Of Char))

参数

propertyName

ReadOnlySpan<Char>

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

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

JSON 的深度超过最大深度 1,000。

• 或 -

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

注解

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

WriteStartArray(String)

编写 JSON 数组的开头，将指定为字符串的属性名称作为键。

public:
 void WriteStartArray(System::String ^ propertyName);

public void WriteStartArray (string propertyName);

member this.WriteStartArray : string -> unit

Public Sub WriteStartArray (propertyName As String)

参数

propertyName

String

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

例外

ArgumentException

指定的属性名称过长。

InvalidOperationException

JSON 的深度超过最大深度 1,000。

• 或 -

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

ArgumentNullException

propertyName 参数为 null。

注解

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

WriteStartArray(JsonEncodedText)

编写将预编码属性名称作为键的 JSON 数组的开头。

public:
 void WriteStartArray(System::Text::Json::JsonEncodedText propertyName);

public void WriteStartArray (System.Text.Json.JsonEncodedText propertyName);

member this.WriteStartArray : System.Text.Json.JsonEncodedText -> unit

Public Sub WriteStartArray (propertyName As JsonEncodedText)

参数

propertyName

JsonEncodedText

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

例外

InvalidOperationException

JSON 的深度超过最大深度 1,000。

• 或 -

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

注解

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