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 時，應該已經逸出屬性名稱。