JsonElement.TryGetProperty Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Sobrecargas

TryGetProperty(String, JsonElement)	Procura uma propriedade chamada propertyName no objeto atual, retornando um valor que indica se essa propriedade existe. Quando a propriedade existe, seu valor é atribuído ao argumento value.
TryGetProperty(ReadOnlySpan<Byte>, JsonElement)	Procura uma propriedade chamada utf8PropertyName no objeto atual, retornando um valor que indica se essa propriedade existe. Quando a propriedade existe, o método atribui seu valor ao argumento value.
TryGetProperty(ReadOnlySpan<Char>, JsonElement)	Procura uma propriedade chamada propertyName no objeto atual, retornando um valor que indica se essa propriedade existe. Quando a propriedade existe, o método atribui seu valor ao argumento value.

TryGetProperty(String, JsonElement)

Procura uma propriedade chamada propertyName no objeto atual, retornando um valor que indica se essa propriedade existe. Quando a propriedade existe, seu valor é atribuído ao argumento 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

Parâmetros

propertyName

String

O nome da propriedade a ser localizada.

value

JsonElement

Quando esse método é retornado, ele contém o valor da propriedade especificada.

Retornos

Boolean

true se a propriedade for encontrada; caso contrário, false.

Exceções

InvalidOperationException

O ValueKind desse valor não é Object.

ArgumentNullException

propertyName é null.

ObjectDisposedException

O JsonDocument pai foi descartado.

Comentários

A correspondência de nome de propriedade é executada como uma comparação ordinal, que diferencia maiúsculas de minúsculas.

Se uma propriedade for definida várias vezes para o mesmo objeto, o método corresponderá à última definição desse tipo.

TryGetProperty(ReadOnlySpan<Byte>, JsonElement)

Procura uma propriedade chamada utf8PropertyName no objeto atual, retornando um valor que indica se essa propriedade existe. Quando a propriedade existe, o método atribui seu valor ao argumento 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

Parâmetros

utf8PropertyName

ReadOnlySpan<Byte>

A representação UTF-8 (sem nenhuma marca de ordem de byte) do nome da propriedade a ser retornada.

value

JsonElement

Recebe o valor da propriedade localizada.

Retornos

Boolean

true se a propriedade for encontrada; caso contrário, false.

Exceções

InvalidOperationException

O ValueKind desse valor não é Object.

ObjectDisposedException

O JsonDocument pai foi descartado.

Comentários

A correspondência de nome de propriedade é executada como uma comparação ordinal, que diferencia maiúsculas de minúsculas.

Se uma propriedade for definida várias vezes para o mesmo objeto, o método corresponderá à última definição desse tipo.

Para obter mais informações, consulte Como escrever serializadores e desserializadores personalizados com System.Text.Json.

TryGetProperty(ReadOnlySpan<Char>, JsonElement)

Procura uma propriedade chamada propertyName no objeto atual, retornando um valor que indica se essa propriedade existe. Quando a propriedade existe, o método atribui seu valor ao argumento 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

Parâmetros

propertyName

ReadOnlySpan<Char>

O nome da propriedade a ser localizada.

value

JsonElement

Quando esse método é retornado, ele contém o valor da propriedade especificada.

Retornos

Boolean

true se a propriedade for encontrada; caso contrário, false.

Exceções

InvalidOperationException

O ValueKind desse valor não é Object.

ObjectDisposedException

O JsonDocument pai foi descartado.

Comentários

A correspondência de nome de propriedade é executada como uma comparação ordinal, que diferencia maiúsculas de minúsculas.

Se uma propriedade for definida várias vezes para o mesmo objeto, o método corresponderá à última definição desse tipo.