JsonElement.TryGetProperty Método

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Sobrecargas

TryGetProperty(String, JsonElement)	Busca una propiedad denominada propertyName en el objeto actual y devuelve un valor que indica si dicha propiedad existe o no. Cuando la propiedad existe, su valor se asigna al argumento value.
TryGetProperty(ReadOnlySpan<Byte>, JsonElement)	Busca una propiedad denominada utf8PropertyName en el objeto actual y devuelve un valor que indica si dicha propiedad existe o no. Cuando la propiedad existe, el método asigna su valor al argumento value.
TryGetProperty(ReadOnlySpan<Char>, JsonElement)	Busca una propiedad denominada propertyName en el objeto actual y devuelve un valor que indica si dicha propiedad existe o no. Cuando la propiedad existe, el método asigna su valor al argumento value.

TryGetProperty(String, JsonElement)

Busca una propiedad denominada propertyName en el objeto actual y devuelve un valor que indica si dicha propiedad existe o no. Cuando la propiedad existe, su valor se asigna al 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

Nombre de la propiedad que se va a buscar.

value

JsonElement

Cuando este método devuelve un resultado, contiene el valor de la propiedad especificada.

Devoluciones

Boolean

true si se encuentra la propiedad; de lo contrario, false.

Excepciones

InvalidOperationException

El elemento ValueKind de este valor no es Object.

ArgumentNullException

propertyName es null.

ObjectDisposedException

Se ha eliminado el elemento primario JsonDocument.

Comentarios

La coincidencia de nombres de propiedad se realiza como una comparación ordinal con distinción entre mayúsculas y minúsculas.

Si una propiedad se define varias veces para el mismo objeto, el método coincide con la última definición de este tipo.

TryGetProperty(ReadOnlySpan<Byte>, JsonElement)

Busca una propiedad denominada utf8PropertyName en el objeto actual y devuelve un valor que indica si dicha propiedad existe o no. Cuando la propiedad existe, el método asigna su valor al 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>

Representación UTF-8 (sin marca de orden de bytes [BOM]) del nombre de la propiedad que se va a devolver.

value

JsonElement

Recibe el valor de la propiedad encontrada.

Devoluciones

Boolean

true si se encuentra la propiedad; de lo contrario, false.

Excepciones

InvalidOperationException

El elemento ValueKind de este valor no es Object.

ObjectDisposedException

Se ha eliminado el elemento primario JsonDocument.

Comentarios

La coincidencia de nombres de propiedad se realiza como una comparación ordinal con distinción entre mayúsculas y minúsculas.

Si una propiedad se define varias veces para el mismo objeto, el método coincide con la última definición de este tipo.

Para obtener más información, vea Cómo escribir serializadores y deserializadores personalizados con System.Text.Json.

TryGetProperty(ReadOnlySpan<Char>, JsonElement)

Busca una propiedad denominada propertyName en el objeto actual y devuelve un valor que indica si dicha propiedad existe o no. Cuando la propiedad existe, el método asigna su valor al 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>

Nombre de la propiedad que se va a buscar.

value

JsonElement

Cuando este método devuelve un resultado, contiene el valor de la propiedad especificada.

Devoluciones

Boolean

true si se encuentra la propiedad; de lo contrario, false.

Excepciones

InvalidOperationException

El elemento ValueKind de este valor no es Object.

ObjectDisposedException

Se ha eliminado el elemento primario JsonDocument.

Comentarios

La coincidencia de nombres de propiedad se realiza como una comparación ordinal con distinción entre mayúsculas y minúsculas.

Si una propiedad se define varias veces para el mismo objeto, el método coincide con la última definición de este tipo.