Compartir a través de


IDocumentClient.ReadConflictAsync Método

Definición

Sobrecargas

ReadConflictAsync(Uri, RequestOptions)

Lee como Conflict una operación asincrónica desde el servicio Azure Cosmos DB.

ReadConflictAsync(String, RequestOptions)

Lee un Conflict elemento del servicio Azure Cosmos DB como una operación asincrónica.

ReadConflictAsync(Uri, RequestOptions)

Lee como Conflict una operación asincrónica desde el servicio Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>> ReadConflictAsync (Uri conflictUri, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member ReadConflictAsync : Uri * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>>
Public Function ReadConflictAsync (conflictUri As Uri, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Conflict))

Parámetros

conflictUri
Uri

URI del recurso Conflict que se va a leer.

options
RequestOptions

Las opciones de solicitud de la solicitud.

Devoluciones

que System.Threading.Tasks contiene un ResourceResponse<TResource>Conflict objeto que contiene el registro de recursos de lectura.

Excepciones

Si conflictUri no se establece.

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:

StatusCodeMotivo de la excepción
404NotFound: significa que el recurso que intentó leer no existía.
429TooManyRequests: esto significa que ha superado el número de unidades de solicitud por segundo. Consulte el valor DocumentClientException.RetryAfter para ver cuánto tiempo debe esperar antes de volver a intentar esta operación.

Ejemplos

//Reads a Conflict resource where 
// - db_id is the ID property of the Database
// - coll_id is the ID property of the DocumentCollection
// - conflict_id is the ID property of the Conflict you wish to read. 
var conflictLink = UriFactory.CreateConflictUri("db_id", "coll_id", "conflict_id");
Conflict conflict = await client.ReadConflictAsync(conflictLink);

Comentarios

Realizar una lectura de un recurso es la manera más eficaz de obtener un recurso del servicio. Si conoce el identificador del recurso, realice una lectura en lugar de una consulta por identificador.

Consulte también

Se aplica a

ReadConflictAsync(String, RequestOptions)

Lee un Conflict elemento del servicio Azure Cosmos DB como una operación asincrónica.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>> ReadConflictAsync (string conflictLink, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member ReadConflictAsync : string * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>>
Public Function ReadConflictAsync (conflictLink As String, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Conflict))

Parámetros

conflictLink
String

Vínculo al conflicto que se va a leer.

options
RequestOptions

(Opcional) Las opciones de solicitud de la solicitud.

Devoluciones

que System.Threading.Tasks contiene un ResourceResponse<TResource>Conflict objeto que contiene el registro de recursos de lectura.

Excepciones

Si conflictLink no se establece.

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:

StatusCodeMotivo de la excepción
404NotFound: significa que el recurso que intentó leer no existía.
429TooManyRequests: esto significa que ha superado el número de unidades de solicitud por segundo. Consulte el valor DocumentClientException.RetryAfter para ver cuánto tiempo debe esperar antes de volver a intentar esta operación.

Ejemplos

//Reads a Conflict resource from a Database
// - sample_database is the ID of the database
// - sample_collection is the ID of the collection
// - conflict_id is the ID of the conflict to be read
var conflictLink = "/dbs/sample_database/colls/sample_collection/conflicts/conflict_id";
Conflict conflict = await client.ReadConflictAsync(conflictLink);

Comentarios

Realizar una lectura de un recurso es la manera más eficaz de obtener un recurso de la base de datos. Si conoce el identificador del recurso, realice una lectura en lugar de una consulta por identificador.

En el ejemplo que se muestra se usan vínculos basados en identificadores, donde el vínculo se compone de las propiedades de identificador usadas cuando se crearon los recursos. Si lo prefiere, puede usar la SelfLink propiedad del conflicto. Un vínculo propio es un URI para un recurso que se compone de identificadores de recursos (o las propiedades _rid). Los vínculos basados en identificadores y SelfLink funcionarán. El formato de conflictLink siempre es "/dbs/{db identifier}/colls/{collectioon identifier}/conflicts/{conflict identifier}" solo los valores de {...} cambian en función del método que desee usar para abordar el recurso.

Consulte también

Se aplica a