Utf8JsonWriter.WriteStartObject 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

多載

WriteStartObject(JsonEncodedText)	以預先編碼的屬性名稱作為索引鍵，寫入 JSON 物件的開頭。
WriteStartObject(String)	以屬性名稱 (指定為字串) 作為索引鍵，寫入 JSON 物件的開頭。
WriteStartObject(ReadOnlySpan<Char>)	寫入 JSON 物件的開頭，並將屬性名稱指定為唯讀字元範圍做為索引鍵。
WriteStartObject()	寫入 JSON 物件的開頭。
WriteStartObject(ReadOnlySpan<Byte>)	以屬性名稱 (指定為唯讀位元組範圍) 作為索引鍵，寫入 JSON 物件的開頭。

WriteStartObject(JsonEncodedText)

來源:

Utf8JsonWriter.cs

以預先編碼的屬性名稱作為索引鍵，寫入 JSON 物件的開頭。

C#

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

參數

propertyName

JsonEncodedText

要轉碼並寫入為 UTF-8 之 JSON 物件的 JSON 編碼屬性名稱。

例外狀況

InvalidOperationException

JSON 的深度已超過最大深度 1,000。

-或-

已啟用驗證，且此方法會導致寫入無效的 JSON。

備註

建立 的 JsonEncodedText 實例時，應該已經逸出屬性名稱。

WriteStartObject(String)

來源:

Utf8JsonWriter.cs

以屬性名稱 (指定為字串) 作為索引鍵，寫入 JSON 物件的開頭。

C#

public void WriteStartObject(string propertyName);

參數

propertyName

String

要轉碼並寫入為 UTF-8 之 JSON 物件的 UTF-16 編碼屬性名稱。

例外狀況

ArgumentException

指定的屬性名稱太大。

InvalidOperationException

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

-或-

已啟用驗證，且此寫入作業會產生無效的 JSON。

ArgumentNullException

propertyName 參數為 null。

備註

屬性名稱會在寫入之前逸出。

WriteStartObject(ReadOnlySpan<Char>)

來源:

Utf8JsonWriter.cs

寫入 JSON 物件的開頭，並將屬性名稱指定為唯讀字元範圍做為索引鍵。

C#

public void WriteStartObject(ReadOnlySpan<char> propertyName);

參數

propertyName

ReadOnlySpan<Char>

要轉碼並寫入為 UTF-8 之 JSON 物件的 UTF-16 編碼屬性名稱。

例外狀況

ArgumentException

指定的屬性名稱太大。

InvalidOperationException

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

-或-

已啟用驗證，且此寫入作業會產生無效的 JSON。

備註

屬性名稱會在寫入之前逸出。

WriteStartObject()

來源:

Utf8JsonWriter.cs

寫入 JSON 物件的開頭。

C#

public void WriteStartObject();

例外狀況

InvalidOperationException

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

-或-

已啟用驗證，且作業會導致寫入無效的 JSON。

WriteStartObject(ReadOnlySpan<Byte>)

來源:

Utf8JsonWriter.cs

以屬性名稱 (指定為唯讀位元組範圍) 作為索引鍵，寫入 JSON 物件的開頭。

C#

public void WriteStartObject(ReadOnlySpan<byte> utf8PropertyName);

參數

utf8PropertyName

ReadOnlySpan<Byte>

要寫入之 JSON 物件的 UTF-8 編碼屬性名稱。

例外狀況

ArgumentException

指定的屬性名稱太大。

InvalidOperationException

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

-或-

已啟用驗證，且此寫入作業會產生無效的 JSON。

備註

屬性名稱會在寫入之前逸出。