JsonElement.TryGetProperty Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Перегрузки

TryGetProperty(String, JsonElement)	Ищет свойство с именем propertyName в текущем объекте, возвращая значение, которое указывает, существует ли такое свойство. Если свойство существует, его значение назначается аргументу value.
TryGetProperty(ReadOnlySpan<Byte>, JsonElement)	Ищет свойство с именем utf8PropertyName в текущем объекте, возвращая значение, которое указывает, существует ли такое свойство. Если свойство существует, метод назначает его значение аргументу value.
TryGetProperty(ReadOnlySpan<Char>, JsonElement)	Ищет свойство с именем propertyName в текущем объекте, возвращая значение, которое указывает, существует ли такое свойство. Если свойство существует, метод назначает его значение аргументу value.

TryGetProperty(String, JsonElement)

Ищет свойство с именем propertyName в текущем объекте, возвращая значение, которое указывает, существует ли такое свойство. Если свойство существует, его значение назначается аргументу value.

public:
 bool TryGetProperty(System::String ^ propertyName, [Runtime::InteropServices::Out] System::Text::Json::JsonElement % value);

public bool TryGetProperty (string propertyName, out System.Text.Json.JsonElement value);

member this.TryGetProperty : string * JsonElement -> bool

Public Function TryGetProperty (propertyName As String, ByRef value As JsonElement) As Boolean

Параметры

propertyName

String

Имя искомого свойства.

value

JsonElement

Когда этот метод возвращает данные, содержит значение указанного свойства.

Возвращаемое значение

Boolean

Значение true, если свойство найдено; в противном случае — значение false.

Исключения

InvalidOperationException

ValueKind этого значения не является Object.

ArgumentNullException

propertyName имеет значение null.

ObjectDisposedException

Родительский объект JsonDocument был удален.

Комментарии

Сопоставление имен свойств выполняется как порядковое сравнение с учетом регистра.

Если свойство определено несколько раз для одного объекта, метод соответствует последнему такому определению.

TryGetProperty(ReadOnlySpan<Byte>, JsonElement)

Ищет свойство с именем utf8PropertyName в текущем объекте, возвращая значение, которое указывает, существует ли такое свойство. Если свойство существует, метод назначает его значение аргументу value.

public:
 bool TryGetProperty(ReadOnlySpan<System::Byte> utf8PropertyName, [Runtime::InteropServices::Out] System::Text::Json::JsonElement % value);

public bool TryGetProperty (ReadOnlySpan<byte> utf8PropertyName, out System.Text.Json.JsonElement value);

member this.TryGetProperty : ReadOnlySpan<byte> * JsonElement -> bool

Public Function TryGetProperty (utf8PropertyName As ReadOnlySpan(Of Byte), ByRef value As JsonElement) As Boolean

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Представление в кодировке UTF-8 (без метки порядка байтов) для имени возвращаемого свойства.

value

JsonElement

Получает значение найденного свойства.

Возвращаемое значение

Boolean

Значение true, если свойство найдено; в противном случае — значение false.

Исключения

InvalidOperationException

ValueKind этого значения не является Object.

ObjectDisposedException

Родительский объект JsonDocument был удален.

Комментарии

Сопоставление имен свойств выполняется как порядковое сравнение с учетом регистра.

Если свойство определено несколько раз для одного объекта, метод соответствует последнему такому определению.

Дополнительные сведения см. в статье о написании пользовательских сериализаторов и десериализаторов с помощью System.Text.Json.

TryGetProperty(ReadOnlySpan<Char>, JsonElement)

Ищет свойство с именем propertyName в текущем объекте, возвращая значение, которое указывает, существует ли такое свойство. Если свойство существует, метод назначает его значение аргументу value.

public:
 bool TryGetProperty(ReadOnlySpan<char> propertyName, [Runtime::InteropServices::Out] System::Text::Json::JsonElement % value);

public bool TryGetProperty (ReadOnlySpan<char> propertyName, out System.Text.Json.JsonElement value);

member this.TryGetProperty : ReadOnlySpan<char> * JsonElement -> bool

Public Function TryGetProperty (propertyName As ReadOnlySpan(Of Char), ByRef value As JsonElement) As Boolean

Параметры

propertyName

ReadOnlySpan<Char>

Имя искомого свойства.

value

JsonElement

Когда этот метод возвращает данные, содержит значение указанного свойства.

Возвращаемое значение

Boolean

Значение true, если свойство найдено; в противном случае — значение false.

Исключения

InvalidOperationException

ValueKind этого значения не является Object.

ObjectDisposedException

Родительский объект JsonDocument был удален.

Комментарии

Сопоставление имен свойств выполняется как порядковое сравнение с учетом регистра.

Если свойство определено несколько раз для одного объекта, метод соответствует последнему такому определению.