Container Classe

Définition

Espace de noms:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.39.0

Source:

Container.cs

Opérations de lecture, de remplacement ou de suppression d’un conteneur ou d’un élément existant spécifique dans un conteneur par ID. Il existe deux types d’opérations différents.

1. Opérations d’objet où il sérialise et désérialise l’élément à la demande/réponse
2. Réponse de flux qui prend un Stream contenant un objet sérialisé JSON et retourne une réponse contenant un Stream See Database pour créer de nouveaux conteneurs et lire/interroger tous les conteneurs.

public abstract class Container

type Container = class

Public MustInherit Class Container

Héritage

Object

Container

Remarques

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système de telle sorte que ces appels soient mis à l’échelle de façon sub linéaire avec votre application. Pour instance, n’appelez pas « container.readAsync() » avant chaque appel « container.readItemAsync() » pour vous assurer que le conteneur existe ; faites-le une fois au démarrage de l’application.

Constructeurs

Container()

Opérations de lecture, de remplacement ou de suppression d’un conteneur ou d’un élément existant spécifique dans un conteneur par ID. Il existe deux types d’opérations différents. Opérations d’objet où il sérialise et désérialise l’élément à la demande/réponse Réponse de flux qui prend un Stream contenant un objet sérialisé JSON et retourne une réponse contenant un Stream See Database pour créer de nouveaux conteneurs et lire/interroger tous les conteneurs.

Propriétés

Conflicts	Retourne les conflits
Database	Retourne la référence de base de données parente
Id	ID du conteneur Cosmos
Scripts	Retourne les scripts

Méthodes

CreateItemAsync<T>(T, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken)	Crée un élément en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateItemStreamAsync(Stream, PartitionKey, ItemRequestOptions, CancellationToken)	Crée un élément en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateTransactionalBatch(PartitionKey)	Initialise une nouvelle instance de TransactionalBatch qui peut être utilisée pour effectuer des opérations sur plusieurs éléments du conteneur avec la clé de partition fournie de manière transactionnelle.
DeleteContainerAsync(ContainerRequestOptions, CancellationToken)	Supprimez un ContainerProperties du service Azure Cosmos DB en tant qu’opération asynchrone.
DeleteContainerStreamAsync(ContainerRequestOptions, CancellationToken)	Supprimez un ContainerProperties du service Azure Cosmos DB en tant qu’opération asynchrone.
DeleteItemAsync<T>(String, PartitionKey, ItemRequestOptions, CancellationToken)	Supprimer un élément du service Azure Cosmos en tant qu’opération asynchrone.
DeleteItemStreamAsync(String, PartitionKey, ItemRequestOptions, CancellationToken)	Supprimer un élément du service Azure Cosmos en tant qu’opération asynchrone.
GetChangeFeedEstimator(String, Container)	Obtient un ChangeFeedEstimator pour la surveillance du flux de modification.
GetChangeFeedEstimatorBuilder(String, Container+ChangesEstimationHandler, Nullable<TimeSpan>)	Initialise un ChangeFeedProcessorBuilder pour la surveillance du flux de modification.
GetChangeFeedIterator<T>(ChangeFeedStartFrom, ChangeFeedMode, ChangeFeedRequestOptions)	Cette méthode crée un itérateur pour consommer un flux de modification.
GetChangeFeedProcessorBuilder(String, Container+ChangeFeedStreamHandler)	Initialise un ChangeFeedProcessorBuilder pour le traitement du flux de modification.
GetChangeFeedProcessorBuilder<T>(String, Container.ChangeFeedHandler<T>)	Initialise un ChangeFeedProcessorBuilder pour le traitement du flux de modification.
GetChangeFeedProcessorBuilder<T>(String, Container.ChangesHandler<T>)	Initialise un ChangeFeedProcessorBuilder pour le traitement du flux de modification.
GetChangeFeedProcessorBuilderWithManualCheckpoint(String, Container+ChangeFeedStreamHandlerWithManualCheckpoint)	Initialise un pour le ChangeFeedProcessorBuilder traitement du flux de modification avec un point de contrôle manuel.
GetChangeFeedProcessorBuilderWithManualCheckpoint<T>(String, Container.ChangeFeedHandlerWithManualCheckpoint<T>)	Initialise un pour le ChangeFeedProcessorBuilder traitement du flux de modification avec un point de contrôle manuel.
GetChangeFeedStreamIterator(ChangeFeedStartFrom, ChangeFeedMode, ChangeFeedRequestOptions)	Cette méthode crée un itérateur pour consommer un flux de modification.
GetFeedRangesAsync(CancellationToken)	Obtient une liste de FeedRange qui peuvent être utilisées pour paralléliser les opérations de flux.
GetItemLinqQueryable<T>(Boolean, String, QueryRequestOptions, CosmosLinqSerializerOptions)	Cette méthode crée une requête LINQ pour les éléments sous un conteneur dans un service Azure Cosmos DB. La méthode d’extension IQueryable ToFeedIterator() doit être utilisée pour l’exécution asynchrone avec FeedIterator. Reportez-vous à l’exemple 2.
GetItemQueryIterator<T>(FeedRange, QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les éléments d’un conteneur dans une base de données Azure Cosmos à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition.
GetItemQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les éléments d’un conteneur dans une base de données Azure Cosmos à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition.
GetItemQueryIterator<T>(String, String, QueryRequestOptions)	Cette méthode crée une requête pour les éléments sous un conteneur dans une base de données Azure Cosmos à l’aide d’une instruction SQL. Elle retourne un FeedIterator.
GetItemQueryStreamIterator(FeedRange, QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les éléments d’un conteneur dans une base de données Azure Cosmos à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition.
GetItemQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les éléments d’un conteneur dans une base de données Azure Cosmos à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition.
GetItemQueryStreamIterator(String, String, QueryRequestOptions)	Cette méthode crée une requête pour les éléments sous un conteneur dans une base de données Azure Cosmos à l’aide d’une instruction SQL. Elle retourne un FeedIterator.
PatchItemAsync<T>(String, PartitionKey, IReadOnlyList<PatchOperation>, PatchItemRequestOptions, CancellationToken)	Corrige un élément du service Azure Cosmos en tant qu’opération asynchrone.
PatchItemStreamAsync(String, PartitionKey, IReadOnlyList<PatchOperation>, PatchItemRequestOptions, CancellationToken)	Corrige un élément du service Azure Cosmos en tant qu’opération asynchrone.
ReadContainerAsync(ContainerRequestOptions, CancellationToken)	Lit un ContainerProperties à partir du service Azure Cosmos en tant qu’opération asynchrone.
ReadContainerStreamAsync(ContainerRequestOptions, CancellationToken)	Lit un ContainerProperties à partir du service Azure Cosmos en tant qu’opération asynchrone.
ReadItemAsync<T>(String, PartitionKey, ItemRequestOptions, CancellationToken)	Lit un élément du service Azure Cosmos en tant qu’opération asynchrone.
ReadItemStreamAsync(String, PartitionKey, ItemRequestOptions, CancellationToken)	Lit un élément du service Azure Cosmos en tant qu’opération asynchrone.
ReadManyItemsAsync<T>(IReadOnlyList<ValueTuple<String,PartitionKey>>, ReadManyRequestOptions, CancellationToken)	Lit plusieurs éléments d’un conteneur à l’aide des valeurs Id et PartitionKey.
ReadManyItemsStreamAsync(IReadOnlyList<ValueTuple<String,PartitionKey>>, ReadManyRequestOptions, CancellationToken)	Lit plusieurs éléments d’un conteneur à l’aide des valeurs Id et PartitionKey.
ReadThroughputAsync(CancellationToken)	Obtient le débit du conteneur dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReadThroughputAsync(RequestOptions, CancellationToken)	Obtient le débit du conteneur dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReplaceContainerAsync(ContainerProperties, ContainerRequestOptions, CancellationToken)	Remplacez un ContainerProperties à partir du service Azure Cosmos en tant qu’opération asynchrone.
ReplaceContainerStreamAsync(ContainerProperties, ContainerRequestOptions, CancellationToken)	Remplacez un ContainerProperties à partir du service Azure Cosmos en tant qu’opération asynchrone.
ReplaceItemAsync<T>(T, String, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken)	Remplace un élément du service Azure Cosmos en tant qu’opération asynchrone.
ReplaceItemStreamAsync(Stream, String, PartitionKey, ItemRequestOptions, CancellationToken)	Remplace un élément du service Azure Cosmos en tant qu’opération asynchrone.
ReplaceThroughputAsync(Int32, RequestOptions, CancellationToken)	Définit le débit approvisionné pour un conteneur dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReplaceThroughputAsync(ThroughputProperties, RequestOptions, CancellationToken)	Définit le débit approvisionné pour un conteneur dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
UpsertItemAsync<T>(T, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken)	Upserts un élément en tant qu’opération asynchrone dans le service Azure Cosmos.
UpsertItemStreamAsync(Stream, PartitionKey, ItemRequestOptions, CancellationToken)	Upserts un flux d’élément en tant qu’opération asynchrone dans le service Azure Cosmos.