DocumentClient.ReadConflictAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| ReadConflictAsync(String, RequestOptions) |
Lit un Conflict à partir du service Azure Cosmos DB en tant qu’opération asynchrone. |
| ReadConflictAsync(Uri, RequestOptions) |
Lit un Conflict en tant qu’opération asynchrone à partir du service Azure Cosmos DB. |
ReadConflictAsync(String, RequestOptions)
Lit un Conflict à partir du service Azure Cosmos DB en tant qu’opération asynchrone.
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>>
override this.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))Paramètres
- conflictLink
- String
Lien vers le conflit à lire.
- options
- RequestOptions
(Facultatif) Options de demande pour la demande.
Retours
System.Threading.Tasks contenant un ResourceResponse<TResource> qui encapsule un Conflict contenant l’enregistrement de ressource de lecture.
Implémente
Exceptions
Si conflictLink n’est pas défini.
Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un document :
| StatusCode | Raison de l’exception |
|---|---|
| 404 | NotFound : cela signifie que la ressource que vous avez tenté de lire n’existait pas. |
| 429 | TooManyRequests : cela signifie que vous avez dépassé le nombre d’unités de requête par seconde. Consultez la valeur DocumentClientException.RetryAfter pour savoir combien de temps vous devez attendre avant de réessayer cette opération. |
Exemples
//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);
Remarques
La lecture d’une ressource est le moyen le plus efficace d’obtenir une ressource à partir de la base de données. Si vous connaissez l’ID de la ressource, effectuez une lecture au lieu d’une requête par ID.
L’exemple présenté utilise des liens basés sur l’ID, où le lien est composé des propriétés d’ID utilisées lors de la création des ressources. Vous pouvez toujours utiliser la SelfLink propriété du conflit si vous préférez. Un lien automatique est un URI pour une ressource composée d’identificateurs de ressource (ou des propriétés _rid). Les liens basés sur l’ID et SelfLink fonctionnent tous les deux. Le format pour conflictLink est toujours « /dbs/{identificateur de base de données}/colls/{collectioon identifier}/conflicts/{identificateur de conflit} » uniquement les valeurs dans le {...} changent selon la méthode que vous souhaitez utiliser pour traiter la ressource.
Voir aussi
S’applique à
ReadConflictAsync(Uri, RequestOptions)
Lit un Conflict en tant qu’opération asynchrone à partir du service 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>>
override this.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))Paramètres
- conflictUri
- Uri
URI de la ressource conflit à lire.
- options
- RequestOptions
Options de demande pour la demande.
Retours
System.Threading.Tasks contenant un ResourceResponse<TResource> qui encapsule un Conflict contenant l’enregistrement de ressource de lecture.
Implémente
Exceptions
Si conflictUri n’est pas défini.
Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un document :
| StatusCode | Raison de l’exception |
|---|---|
| 404 | NotFound : cela signifie que la ressource que vous avez tenté de lire n’existait pas. |
| 429 | TooManyRequests : cela signifie que vous avez dépassé le nombre d’unités de requête par seconde. Consultez la valeur DocumentClientException.RetryAfter pour savoir combien de temps vous devez attendre avant de réessayer cette opération. |
Exemples
//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);
Remarques
La lecture d’une ressource est le moyen le plus efficace d’obtenir une ressource auprès du service. Si vous connaissez l’ID de la ressource, effectuez une lecture au lieu d’une requête par ID.
Voir aussi
S’applique à
Azure SDK for .NET