RequestOptions.PartitionKey Propriété

Référence

Définition

Espace de noms:: Microsoft.Azure.Documents.Client

Assemblys:: Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Paquets:: Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

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.

Obtient ou définit le PartitionKey pour la requête actuelle dans le service Azure Cosmos DB.

public Microsoft.Azure.Documents.PartitionKey PartitionKey { get; set; }

member this.PartitionKey : Microsoft.Azure.Documents.PartitionKey with get, set

Public Property PartitionKey As PartitionKey

Valeur de propriété

PartitionKey

Exemples

L’exemple suivant montre comment lire un document dans une collection partitionnée à l’aide de PartitionKey. L’exemple suppose que la collection est créée avec une PartitionKeyDefinition de la propriété « id » dans tous les documents.

await client.ReadDocumentAsync(
    document.SelfLink,
    new RequestOptions { PartitionKey = new PartitionKey(document.Id) } );

Remarques

La clé de partition est utilisée pour identifier la partition cible pour cette requête. Il doit être défini sur les opérations de lecture et de suppression pour toutes les demandes de document ; opérations de création, de lecture, de mise à jour et de suppression pour toutes les demandes de pièces jointes de document ; et exécutent l’opération sur les productions stockées.

Pour les opérations de création et de mise à jour sur des documents, la clé de partition est facultative. En cas d’absence, la bibliothèque cliente extrait la clé de partition du document avant d’envoyer la demande au serveur.

S’applique à

Partager via