Utf8JsonWriter.WriteNull 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

套件:

System.Text.Json v9.0.0-preview.3.24172.9

多載

WriteNull(ReadOnlySpan<Byte>)	寫入屬性名稱 (指定為唯讀位元組範圍) 和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。
WriteNull(ReadOnlySpan<Char>)	寫入屬性名稱 (指定為唯讀字元範圍) 和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。
WriteNull(String)	寫入屬性名稱 (指定為字串) 和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。
WriteNull(JsonEncodedText)	寫入預先編碼的屬性名稱和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。

WriteNull(ReadOnlySpan<Byte>)

來源:

Utf8JsonWriter.WriteProperties.Literal.cs

寫入屬性名稱 (指定為唯讀位元組範圍) 和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。

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

public void WriteNull (ReadOnlySpan<byte> utf8PropertyName);

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

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

參數

utf8PropertyName

ReadOnlySpan<Byte>

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

例外狀況

ArgumentException

指定的屬性名稱太大。

InvalidOperationException

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

備註

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

WriteNull(ReadOnlySpan<Char>)

來源:

Utf8JsonWriter.WriteProperties.Literal.cs

寫入屬性名稱 (指定為唯讀字元範圍) 和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。

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

public void WriteNull (ReadOnlySpan<char> propertyName);

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

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

參數

propertyName

ReadOnlySpan<Char>

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

例外狀況

ArgumentException

指定的屬性名稱太大。

InvalidOperationException

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

備註

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

WriteNull(String)

來源:

Utf8JsonWriter.WriteProperties.Literal.cs

寫入屬性名稱 (指定為字串) 和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。

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

public void WriteNull (string propertyName);

member this.WriteNull : string -> unit

Public Sub WriteNull (propertyName As String)

參數

propertyName

String

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

例外狀況

ArgumentException

指定的屬性名稱太大。

InvalidOperationException

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

ArgumentNullException

propertyName 參數為 null。

備註

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

WriteNull(JsonEncodedText)

來源:

Utf8JsonWriter.WriteProperties.Literal.cs

寫入預先編碼的屬性名稱和 JSON 常值 null，作為 JSON 物件名稱/值組的一部分。

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

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

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

Public Sub WriteNull (propertyName As JsonEncodedText)

參數

propertyName

JsonEncodedText

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

例外狀況

InvalidOperationException

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

備註

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