Utf8JsonWriter.WriteNull Метод

Определение

Пространство имен:

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

System.Text.Json v11.0.0-preview.4.26230.115

Перегрузки

Имя	Описание
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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

Исключения

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-16 объекта JSON, которое должно быть перекодировано и записано как UTF-8.

Исключения

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-16 объекта JSON, которое должно быть перекодировано и записано как UTF-8.

Исключения

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

Закодированное в формате JSON имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

Исключения

InvalidOperationException

Проверка включена, и этот метод приведет к написанию недопустимого JSON.

Комментарии

Имя свойства уже должно быть экранировано при создании экземпляра JsonEncodedText .