Partager via


BlockBlobClient Classe

Définition

vous BlockBlobClient permet de manipuler des objets blob de blocs de stockage Azure.

Les objets blob de blocs vous permettent de télécharger efficacement des objets blob volumineux. Les objets BLOB de blocs sont composés de blocs, chacun étant identifié par un ID de bloc. Vous créez ou modifiez un objet BLOB de blocs en écrivant un ensemble de blocs et en validant leur ID de bloc. Chaque bloc peut avoir une taille différente, jusqu’à un maximum de 4 000 Mo (100 Mo pour les demandes utilisant des versions REST antérieures à 2019-12-2012 et 4 Mo pour les demandes utilisant des versions REST antérieures au 31-05-2016), et un objet blob de blocs peut inclure jusqu’à 50 000 blocs. La taille maximale d’un objet blob de blocs est donc d’environ 190,73 Tio (4 000 Mo x 50 000 blocs). Si vous écrivez un objet blob de blocs dont la taille ne dépasse pas 5 000 Mo, vous pouvez le charger dans son intégralité avec une seule opération d’écriture ; consultez UploadAsync(Stream, BlobUploadOptions, CancellationToken).

Quand vous téléchargez un bloc dans un objet BLOB de votre compte de stockage, il est associé à l'objet BLOB de blocs spécifié, mais il ne fait pas partie de l'objet BLOB tant que vous n'avez pas validé une liste de blocs incluant l'ID du nouveau bloc. Les nouveaux blocs restent en état non validé tant qu'ils ne sont pas spécifiquement validés ou ignorés. L'écriture d'un bloc ne met pas à jour l'heure de dernière modification d'un objet blob existant.

Les objets blob de blocs incluent des fonctionnalités qui vous aident à gérer les fichiers volumineux sur un réseau. Avec un objet blob de blocs, vous pouvez télécharger plusieurs blocs en parallèle pour réduire le temps de téléchargement. Chaque bloc peut inclure un hachage MD5 pour vérifier le transfert, ce qui vous permet de suivre la progression du chargement et de renvoyer les blocs si nécessaire. Vous pouvez charger des blocs dans n’importe quel ordre et déterminer leur séquence à l’étape finale d’engagement de la liste de blocs. Vous pouvez aussi télécharger un nouveau bloc pour remplacer un bloc validé existant associé au même ID de bloc. Vous avez une semaine pour valider les blocs dans un objet BLOB avant qu'ils soient ignorés. Tous les blocs non validés sont ignorés quand ils sont exclus lors d'une opération de validation de liste de blocs.

Vous pouvez modifier un objet blob de blocs existant en insérant, remplaçant ou supprimant des blocs existants. Après avoir téléchargé le ou les blocs modifiés, vous pouvez valider une nouvelle version de l'objet blob en validant les nouveaux blocs en même temps que les blocs existants que vous souhaitez conserver en une seule opération de validation. Pour insérer la même plage d’octets à deux emplacements différents de l’objet blob validé, vous pouvez valider le même bloc à deux emplacements dans la même opération de validation. Pour toute opération de validation, si un bloc est introuvable, l’opération d’engagement entière échoue avec une erreur et l’objet blob n’est pas modifié. Toute validation de bloc remplace les propriétés et les métadonnées existantes de l'objet BLOB, et ignore tous les blocs non validés.

Les ID de bloc sont des chaînes de longueur égale dans un objet blob. Le code client de bloc utilise généralement le codage en base 64 pour normaliser les chaînes en longueurs égales. Dans le codage en base 64, la chaîne précodée doit mesurer 64 octets maximum. Les valeurs d'ID de bloc peuvent être dupliquées dans différents objets blob. Un objet blob peut avoir jusqu’à 100 000 blocs non validés, avec une taille totale maximale de 381,46 Tio (4 000 Mo x 100 000 blocs)

Si vous écrivez un bloc pour un objet blob qui n'existe pas, un nouvel objet blob de blocs est créé avec une longueur de zéro octet. Cet objet blob apparaît dans les listes d'objets blob qui incluent les objets blob non validés. Si vous ne validez aucun bloc de cet objet BLOB, ce dernier ainsi que ses blocs non validés seront ignorés au bout d'une semaine après le dernier téléchargement de blocs. Tous les blocs non validés sont également ignorés lorsqu’un nouvel objet blob du même nom est créé à l’aide d’une seule étape (plutôt que du processus de chargement de blocs en deux étapes).

public class BlockBlobClient : Azure.Storage.Blobs.Specialized.BlobBaseClient
type BlockBlobClient = class
    inherit BlobBaseClient
Public Class BlockBlobClient
Inherits BlobBaseClient
Héritage
BlockBlobClient

Constructeurs

BlockBlobClient()

Initialise une nouvelle instance de la classe pour la BlockBlobClient simulation.

BlockBlobClient(String, String, String)

Initialise une nouvelle instance de la classe BlockBlobClient.

BlockBlobClient(String, String, String, BlobClientOptions)

Initialise une nouvelle instance de la classe BlockBlobClient.

BlockBlobClient(Uri, AzureSasCredential, BlobClientOptions)

Initialise une nouvelle instance de la classe BlockBlobClient.

BlockBlobClient(Uri, BlobClientOptions)

Initialise une nouvelle instance de la classe BlockBlobClient.

BlockBlobClient(Uri, StorageSharedKeyCredential, BlobClientOptions)

Initialise une nouvelle instance de la classe BlockBlobClient.

BlockBlobClient(Uri, TokenCredential, BlobClientOptions)

Initialise une nouvelle instance de la classe BlockBlobClient.

Propriétés

AccountName

Obtient le nom du compte de stockage correspondant au client d’objets blob.

(Hérité de BlobBaseClient)
BlobContainerName

Obtient le nom du conteneur correspondant au client d’objets blob.

(Hérité de BlobBaseClient)
BlockBlobMaxBlocks

Obtient le nombre maximal de blocs autorisé dans un objet blob de blocs.

BlockBlobMaxStageBlockLongBytes

Obtient le nombre maximal d’octets pouvant être envoyés dans un appel à Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken).

BlockBlobMaxUploadBlobLongBytes

Obtient le nombre maximal d’octets pouvant être envoyés dans un appel à UploadAsync(Stream, BlobUploadOptions, CancellationToken).

CanGenerateSasUri

Détermine si le client est en mesure de générer une sap. Si le client est authentifié avec un StorageSharedKeyCredential.

(Hérité de BlobBaseClient)
Name

Obtient le nom de l'objet blob.

(Hérité de BlobBaseClient)
Uri

Obtient le point de terminaison principal Uri de l’objet blob.

(Hérité de BlobBaseClient)

Méthodes

AbortCopyFromUri(String, BlobRequestConditions, CancellationToken)

L’opération AbortCopyFromUri(String, BlobRequestConditions, CancellationToken) abandonne un objet en attente CopyFromUriOperationet laisse un objet blob sans aucune longueur et des métadonnées complètes.

Pour plus d'informations, consultez la rubrique Abandonner l’objet blob de copie.

(Hérité de BlobBaseClient)
AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken)

L’opération AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken) abandonne un objet en attente CopyFromUriOperationet laisse un objet blob sans aucune longueur et des métadonnées complètes.

Pour plus d'informations, consultez la rubrique Abandonner l’objet blob de copie.

(Hérité de BlobBaseClient)
CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

L'opération CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) écrit un objet blob en spécifiant la liste des ID de bloc qui le composent. Afin d'être écrit dans le cadre d'un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) précédente. Vous pouvez appeler CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) pour mettre à jour un objet blob en téléchargeant uniquement les blocs qui ont changé, puis en validant les blocs nouveaux et existants. Vous pouvez faire cela en spécifiant si un bloc doit être validé à partir de la liste de blocs validés ou de la liste de blocs non validés, ou si la version du bloc téléchargée en dernier doit être validée en indiquant la liste auquel le bloc appartient. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement.

Pour plus d'informations, consultez la rubrique Mettre la liste de blocs.

CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

L'opération CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) écrit un objet blob en spécifiant la liste des ID de bloc qui le composent. Afin d'être écrit dans le cadre d'un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) précédente. Vous pouvez appeler CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) pour mettre à jour un objet blob en téléchargeant uniquement les blocs qui ont changé, puis en validant les blocs nouveaux et existants. Vous pouvez faire cela en spécifiant si un bloc doit être validé à partir de la liste de blocs validés ou de la liste de blocs non validés, ou si la version du bloc téléchargée en dernier doit être validée en indiquant la liste auquel le bloc appartient. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement.

Pour plus d'informations, consultez la rubrique Mettre la liste de blocs.

CreateClient(Uri, BlobClientOptions, HttpPipeline)

Initialise une nouvelle instance de la classe BlockBlobClient.

CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

L'opération CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken) crée un instantané en lecture seule d'un objet blob.

Pour plus d'informations, consultez la rubrique Objet blob d’instantané.

(Hérité de BlobBaseClient)
CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

L'opération CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) crée un instantané en lecture seule d'un objet blob.

Pour plus d'informations, consultez la rubrique Objet blob d’instantané.

(Hérité de BlobBaseClient)
Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

L'opération Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marque l'objet blob ou l'instantané spécifié pour suppression. L’objet blob est ensuite supprimé pendant le garbage collection, ce qui peut prendre plusieurs minutes.

Notez que pour supprimer un objet blob, vous devez supprimer tous ses instantanés. Vous pouvez supprimer les deux en même temps à l’aide de IncludeSnapshots.

Pour plus d'informations, consultez la rubrique Supprimer l’objet blob.

(Hérité de BlobBaseClient)
DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

L'opération DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marque l'objet blob ou l'instantané spécifié pour suppression. L’objet blob est ensuite supprimé pendant le garbage collection, ce qui peut prendre plusieurs minutes.

Notez que pour supprimer un objet blob, vous devez supprimer tous ses instantanés. Vous pouvez supprimer les deux en même temps à l’aide de IncludeSnapshots.

Pour plus d'informations, consultez la rubrique Supprimer l’objet blob.

(Hérité de BlobBaseClient)
DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

L’opération DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marque l’objet blob ou le instantané spécifié pour suppression, si l’objet blob existe. L’objet blob est ensuite supprimé pendant le garbage collection, ce qui peut prendre plusieurs minutes.

Notez que pour supprimer un objet blob, vous devez supprimer tous ses instantanés. Vous pouvez supprimer les deux en même temps à l’aide de IncludeSnapshots.

Pour plus d'informations, consultez la rubrique Supprimer l’objet blob.

(Hérité de BlobBaseClient)
DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

L’opération DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marque l’objet blob ou le instantané spécifié pour suppression, si l’objet blob existe. L’objet blob est ensuite supprimé pendant le garbage collection, ce qui peut prendre plusieurs minutes.

Notez que pour supprimer un objet blob, vous devez supprimer tous ses instantanés. Vous pouvez supprimer les deux en même temps à l’aide de IncludeSnapshots.

Pour plus d'informations, consultez la rubrique Supprimer l’objet blob.

(Hérité de BlobBaseClient)
DeleteImmutabilityPolicy(CancellationToken)

Supprime la stratégie d’immuabilité associée à l’objet blob. Notez que le contrôle de version d’objets blob doit être activé sur votre compte de stockage et que l’objet blob doit se trouver dans un conteneur avec un stockage immuable avec le contrôle de version activé pour appeler cette API.

(Hérité de BlobBaseClient)
DeleteImmutabilityPolicyAsync(CancellationToken)

Supprime la stratégie d’immuabilité associée à l’objet blob. Notez que le contrôle de version d’objets blob doit être activé sur votre compte de stockage et que l’objet blob doit se trouver dans un conteneur avec un stockage immuable avec le contrôle de version activé pour appeler cette API.

(Hérité de BlobBaseClient)
DownloadContent()

L’opération DownloadContent() télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadContent(BlobDownloadOptions, CancellationToken)

L’opération DownloadContent(BlobDownloadOptions, CancellationToken) télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadContent(CancellationToken)

L’opération DownloadContent(CancellationToken) télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadContentAsync()

L’opération DownloadContentAsync() télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadContentAsync(BlobDownloadOptions, CancellationToken)

L’opération DownloadContentAsync(BlobDownloadOptions, CancellationToken) télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadContentAsync(CancellationToken)

L’opération DownloadContentAsync(CancellationToken) télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadStreaming(BlobDownloadOptions, CancellationToken)

L’opération DownloadStreaming(BlobDownloadOptions, CancellationToken) télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadStreamingAsync(BlobDownloadOptions, CancellationToken)

L’opération DownloadStreamingAsync(BlobDownloadOptions, CancellationToken) télécharge un objet blob à partir du service, y compris ses métadonnées et ses propriétés.

Pour plus d'informations, consultez la rubrique Obtenir un objet blob.

(Hérité de BlobBaseClient)
DownloadTo(Stream)

L’opération DownloadTo(Stream) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans destination.

(Hérité de BlobBaseClient)
DownloadTo(Stream, BlobDownloadToOptions, CancellationToken)

L’opération Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans options.Path.Path ou options.Stream.Stream.

(Hérité de BlobBaseClient)
DownloadTo(Stream, CancellationToken)

L’opération DownloadTo(Stream, CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans destination.

(Hérité de BlobBaseClient)
DownloadTo(String)

L’opération DownloadTo(String) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans path.

(Hérité de BlobBaseClient)
DownloadTo(String, BlobDownloadToOptions, CancellationToken)

L’opération Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans options.Path.Path ou options.Stream.Stream.

(Hérité de BlobBaseClient)
DownloadTo(String, CancellationToken)

L’opération DownloadTo(String, CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans path.

(Hérité de BlobBaseClient)
DownloadToAsync(Stream)

télécharge DownloadToAsync(Stream) un objet blob à l’aide de requêtes parallèles et écrit le contenu dans destination.

(Hérité de BlobBaseClient)
DownloadToAsync(Stream, BlobDownloadToOptions, CancellationToken)

L’opération Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans options.Path.Path ou options.Stream.Stream.

(Hérité de BlobBaseClient)
DownloadToAsync(Stream, CancellationToken)

L’opération DownloadToAsync(Stream, CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans destination.

(Hérité de BlobBaseClient)
DownloadToAsync(String)

télécharge DownloadToAsync(String) un objet blob à l’aide de requêtes parallèles et écrit le contenu dans path.

(Hérité de BlobBaseClient)
DownloadToAsync(String, BlobDownloadToOptions, CancellationToken)

L’opération Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans options.Path.Path ou options.Stream.Stream.

(Hérité de BlobBaseClient)
DownloadToAsync(String, CancellationToken)

L’opération DownloadToAsync(String, CancellationToken) télécharge un objet blob à l’aide de requêtes parallèles et écrit le contenu dans path.

(Hérité de BlobBaseClient)
Exists(CancellationToken)

L’opération Exists(CancellationToken) peut être appelée sur un BlobBaseClient pour voir si l’objet blob associé existe dans le conteneur sur le compte de stockage dans le service de stockage.

(Hérité de BlobBaseClient)
ExistsAsync(CancellationToken)

L’opération ExistsAsync(CancellationToken) peut être appelée sur un BlobBaseClient pour voir si l’objet blob associé existe dans le conteneur sur le compte de stockage dans le service de stockage.

(Hérité de BlobBaseClient)
GenerateSasUri(BlobSasBuilder)

retourne GenerateSasUri(BlobSasBuilder) un Uri qui génère un URI de signature d’accès partagé du service Blob (SAS) en fonction des propriétés du client et du générateur et . La signature SAS est signée par les informations d’identification de clé partagée du client.

Pour case activée si le client est en mesure de signer un sas de service, consultez CanGenerateSasUri.

Pour plus d'informations, consultez la rubrique Construction d’une SAP de service.

(Hérité de BlobBaseClient)
GenerateSasUri(BlobSasPermissions, DateTimeOffset)

Retourne GenerateSasUri(BlobSasPermissions, DateTimeOffset) un Uri qui génère un URI de signature d’accès partagé du service Blob (SAS) en fonction des propriétés clientes et des paramètres passés. La signature SAS est signée par les informations d’identification de clé partagée du client.

Pour case activée si le client est en mesure de signer un sas de service, consultez CanGenerateSasUri.

Pour plus d'informations, consultez la rubrique Construction d’une sap de service.

(Hérité de BlobBaseClient)
GetBlobLeaseClientCore(String)

Initialise une nouvelle instance de la classe BlobLeaseClient.

(Hérité de BlobBaseClient)
GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken)

L’opération GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken) récupère la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs. Deux listes de blocs sont conservées pour un objet blob. La liste des blocs validés contient des blocs qui ont été correctement validés dans un objet blob donné avec CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken). La liste des blocs non validés contient des blocs qui ont été chargés pour un objet blob à l’aide Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)de , mais qui n’ont pas encore été validés. Ces blocs sont stockés dans Azure et associés à un objet blob, mais ne font pas partie de l'objet blob.

GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken)

L’opération GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken) récupère la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs. Deux listes de blocs sont conservées pour un objet blob. La liste des blocs validés contient des blocs qui ont été correctement validés dans un objet blob donné avec CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken). La liste des blocs non validés contient des blocs qui ont été chargés pour un objet blob à l’aide Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)de , mais qui n’ont pas encore été validés. Ces blocs sont stockés dans Azure et associés à un objet blob, mais ne font pas partie de l'objet blob.

GetParentBlobContainerClientCore()

Créez un BlobContainerClient qui pointe vers ce BlobBaseClientconteneur parent. Le nouveau BlockBlobClient utilise le même pipeline de stratégie de requête que le BlobBaseClient.

(Hérité de BlobBaseClient)
GetProperties(BlobRequestConditions, CancellationToken)

L'opération GetProperties(BlobRequestConditions, CancellationToken) retourne toutes les métadonnées définies par l'utilisateur, les propriétés HTTP standard et les propriétés système pour l'objet blob. Elle ne retourne pas le contenu de l'objet blob.

Pour plus d'informations, consultez la rubrique Obtenir les propriétés d’objet blob.

(Hérité de BlobBaseClient)
GetPropertiesAsync(BlobRequestConditions, CancellationToken)

L'opération GetPropertiesAsync(BlobRequestConditions, CancellationToken) retourne toutes les métadonnées définies par l'utilisateur, les propriétés HTTP standard et les propriétés système pour l'objet blob. Elle ne retourne pas le contenu de l'objet blob.

Pour plus d'informations, consultez la rubrique Obtenir les propriétés d’objet blob.

(Hérité de BlobBaseClient)
GetTags(BlobRequestConditions, CancellationToken)

Obtient les balises associées à l’objet blob sous-jacent.

Pour plus d'informations, consultez la rubrique Obtenir des balises d’objets blob

(Hérité de BlobBaseClient)
GetTagsAsync(BlobRequestConditions, CancellationToken)

Obtient les balises associées à l’objet blob sous-jacent.

Pour plus d'informations, consultez la rubrique Obtenir des balises d’objets blob

(Hérité de BlobBaseClient)
OpenRead(BlobOpenReadOptions, CancellationToken)

Ouvre un flux de données pour lire à partir de l'objet blob. Le flux télécharge uniquement le blob pendant la lecture du flux.

(Hérité de BlobBaseClient)
OpenReadAsync(BlobOpenReadOptions, CancellationToken)

Ouvre un flux de données pour lire à partir de l'objet blob. Le flux télécharge uniquement le blob pendant la lecture du flux.

(Hérité de BlobBaseClient)
OpenWrite(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

Ouvre un flux de données pour écrire dans l'objet blob.

OpenWriteAsync(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

Ouvre un flux de données pour écrire dans l'objet blob. Si l’objet blob existe, il est remplacé.

Query(String, BlobQueryOptions, CancellationToken)

L’API Query(String, BlobQueryOptions, CancellationToken) retourne le résultat d’une requête sur l’objet blob.

Pour plus d'informations, consultez la rubrique Interroger le contenu de l’objet blob.

QueryAsync(String, BlobQueryOptions, CancellationToken)

L’API QueryAsync(String, BlobQueryOptions, CancellationToken) retourne le résultat d’une requête sur l’objet blob.

Pour plus d'informations, consultez la rubrique Interroger le contenu de l’objet blob.

SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

L’opération SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) définit le niveau sur un objet blob. L’opération est autorisée sur un objet blob de page dans un compte de stockage Premium et sur un objet blob de blocs dans un compte de stockage d’objets blob ou à usage général v2.

Le niveau d’un objet blob de page Premium détermine la taille, les IOPS et la bande passante autorisées de l’objet blob. Le niveau d’un objet blob de blocs détermine le type de stockage Chaud/Froid/Archive. Cette opération ne met pas à jour l’ETag de l’objet blob. Pour obtenir des informations détaillées sur la hiérarchisation au niveau des objets blob au niveau des blocs.

Pour plus d’informations sur la définition du niveau, consultez Niveaux de stockage Blob.

(Hérité de BlobBaseClient)
SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

L’opération SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) définit le niveau sur un objet blob. L’opération est autorisée sur un objet blob de page dans un compte de stockage Premium et sur un objet blob de blocs dans un compte de stockage d’objets blob ou à usage général v2.

Le niveau d’un objet blob de page Premium détermine la taille, les IOPS et la bande passante autorisées de l’objet blob. Le niveau d’un objet blob de blocs détermine le type de stockage Chaud/Froid/Archive. Cette opération ne met pas à jour l’ETag de l’objet blob. Pour obtenir des informations détaillées sur la hiérarchisation au niveau des objets blob au niveau des blocs.

Pour plus d’informations sur la définition du niveau, consultez Niveaux de stockage Blob.

(Hérité de BlobBaseClient)
SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

L'opération SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken) définit les propriétés système de l'objet blob.

Pour plus d'informations, consultez la rubrique Définissez propriétés d’objet blob.

(Hérité de BlobBaseClient)
SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

L'opération SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken) définit les propriétés système de l'objet blob.

Pour plus d'informations, consultez la rubrique Définissez propriétés d’objet blob.

(Hérité de BlobBaseClient)
SetImmutabilityPolicy(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Définit la stratégie d’immuabilité sur un objet blob, un instantané d’objet blob ou une version d’objet blob. Notez que le contrôle de version d’objets blob doit être activé sur votre compte de stockage et que l’objet blob doit se trouver dans un conteneur avec un stockage immuable avec le contrôle de version activé pour appeler cette API.

(Hérité de BlobBaseClient)
SetImmutabilityPolicyAsync(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Définit la stratégie d’immuabilité sur un objet blob, un instantané d’objet blob ou une version d’objet blob. Notez que le contrôle de version d’objets blob doit être activé sur votre compte de stockage et que l’objet blob doit se trouver dans un conteneur avec un stockage immuable avec le contrôle de version activé pour appeler cette API.

(Hérité de BlobBaseClient)
SetLegalHold(Boolean, CancellationToken)

Définit une conservation légale sur l’objet blob. Notez que le contrôle de version d’objets blob doit être activé sur votre compte de stockage et que l’objet blob doit se trouver dans un conteneur avec un stockage immuable avec le contrôle de version activé pour appeler cette API.

(Hérité de BlobBaseClient)
SetLegalHoldAsync(Boolean, CancellationToken)

Définit une conservation légale sur l’objet blob. Notez que le contrôle de version d’objets blob doit être activé sur votre compte de stockage et que l’objet blob doit se trouver dans un conteneur avec un stockage immuable avec le contrôle de version activé pour appeler cette API.

(Hérité de BlobBaseClient)
SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

L'opération SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken) définit les métadonnées définies par l'utilisateur pour l'objet blob spécifié sous la forme de paires nom-valeur.

Pour plus d'informations, consultez la rubrique Définissez les métadonnées d’objets blob.

(Hérité de BlobBaseClient)
SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

L'opération SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) définit les métadonnées définies par l'utilisateur pour l'objet blob spécifié sous la forme de paires nom-valeur.

Pour plus d'informations, consultez la rubrique Définissez les métadonnées d’objets blob.

(Hérité de BlobBaseClient)
SetTags(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Définit des balises sur l’objet blob sous-jacent. Un objet blob peut avoir jusqu’à 10 balises. Les clés de balise doivent comporter entre 1 et 128 caractères. Les valeurs de balise doivent être comprises entre 0 et 256 caractères. Les caractères de clé de balise et de valeur valides incluent les lettres minuscules et majuscules, les chiffres (0-9), l’espace (''), plus ('+'), moins ('-'), point ('.'), la barre oblique ('/'), les deux-points (':'), égal à ('=') et le trait de soulignement ('_') .

Pour plus d'informations, consultez la rubrique Définissez des balises d’objet blob.

(Hérité de BlobBaseClient)
SetTagsAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Définit des balises sur l’objet blob sous-jacent. Un objet blob peut avoir jusqu’à 10 balises. Les clés de balise doivent comporter entre 1 et 128 caractères. Les valeurs de balise doivent être comprises entre 0 et 256 caractères. Les caractères de clé de balise et de valeur valides incluent les lettres minuscules et majuscules, les chiffres (0-9), l’espace (''), plus ('+'), moins ('-'), point ('.'), la barre oblique ('/'), les deux-points (':'), égal à ('=') et le trait de soulignement ('_') .

Pour plus d'informations, consultez la rubrique Définissez des balises d’objet blob.

(Hérité de BlobBaseClient)
StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

L’opération StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) crée un bloc dans le cadre de la « zone intermédiaire » d’un objet blob de blocs pour qu’il soit finalement validé via l’opération CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

Pour plus d'informations, consultez la rubrique Mettez bloquer.

StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

L’opération StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) crée un bloc dans le cadre de la « zone intermédiaire » d’un objet blob de blocs pour qu’il soit finalement validé via l’opération CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

Pour plus d'informations, consultez la rubrique Mettez bloquer.

StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken)

L’opération StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken) crée un nouveau bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir de sourceUri.

Pour plus d'informations, consultez la rubrique Placez bloquer à partir de l’URL.

StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken)

L’opération StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken) crée un nouveau bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir de sourceUri.

Pour plus d'informations, consultez la rubrique Placez bloquer à partir de l’URL.

StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

L’opération StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) commence une copie asynchrone des données de vers source cet objet blob. Vous pouvez case activée le Azure.Storage.Blobs.Models.BlobProperties.CopyStatus retourné à partir de pour GetProperties(BlobRequestConditions, CancellationToken) déterminer si la copie est terminée.

Pour plus d'informations, consultez la rubrique Copiez l’objet blob.

(Hérité de BlobBaseClient)
StartCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

L’opération Azure.Storage.Blobs.Specialized.BlobBaseClient.StartCopyFromUri(System.Uri,System.Collections.Generic.IDictionary{System.String,System.String},System.Nullable{Azure.Storage.Blobs.Models.AccessTier},Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.Blobs.Models.BlobRequestConditions,System.Nullable{Azure.Storage.Blobs.Models.RehydratePriority},System.Threading.CancellationToken) commence une copie asynchrone des données de vers source cet objet blob. Vous pouvez case activée le Azure.Storage.Blobs.Models.BlobProperties.CopyStatus retourné à partir de pour GetPropertiesAsync(BlobRequestConditions, CancellationToken) déterminer si la copie est terminée.

Pour plus d'informations, consultez la rubrique Copier l’objet blob.

(Hérité de BlobBaseClient)
SyncCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

L’opération Copier l’objet blob à partir de l’URL copie un objet blob vers une destination dans le compte de stockage de manière synchrone pour des tailles d’objet blob source allant jusqu’à 256 Mio. Cette API est disponible à partir de la version 2018-03-28. La source d’une opération Copier un objet blob à partir d’une URL peut être n’importe quel objet blob de blocs validé dans n’importe quel compte de stockage Azure qui est public ou autorisé avec une signature d’accès partagé.

La taille de l’objet blob source peut être d’une longueur maximale de 256 Mio.

Pour plus d'informations, consultez la rubrique Copier l’objet blob à partir de l’URL.

(Hérité de BlobBaseClient)
SyncCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

L’opération Copier l’objet blob à partir de l’URL copie un objet blob vers une destination dans le compte de stockage de manière synchrone pour des tailles d’objet blob source allant jusqu’à 256 Mio. Cette API est disponible à partir de la version 2018-03-28. La source d’une opération Copier un objet blob à partir d’une URL peut être n’importe quel objet blob de blocs validé dans n’importe quel compte de stockage Azure qui est public ou autorisé avec une signature d’accès partagé.

La taille de l’objet blob source peut être d’une longueur maximale de 256 Mio.

Pour plus d'informations, consultez la rubrique Copier l’objet blob à partir de l’URL.

(Hérité de BlobBaseClient)
SyncUploadFromUri(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

L’opération Charger à partir de l’URI crée un objet blob de blocs où le contenu de l’objet blob est lu à partir d’une URL donnée. Cette API est prise en charge à partir de la version 2020-04-08.

Les mises à jour partielles ne sont pas prises en charge avec Put Blob from URL ; le contenu d’un objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer des mises à jour partielles du contenu d’un objet blob de blocs à l’aide d’une URL source, utilisez l’API Put Block from URL conjointement avec Put Block List.

SyncUploadFromUri(Uri, Boolean, CancellationToken)

L’opération Charger à partir de l’URI crée un objet blob de blocs où le contenu de l’objet blob est lu à partir d’une URL donnée. Cette API est prise en charge à partir de la version 2020-04-08.

Les mises à jour partielles ne sont pas prises en charge avec Put Blob from URL ; le contenu d’un objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer des mises à jour partielles du contenu d’un objet blob de blocs à l’aide d’une URL source, utilisez l’API Put Block from URL conjointement avec Put Block List.

SyncUploadFromUriAsync(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

L’opération Charger à partir de l’URI crée un objet blob de blocs où le contenu de l’objet blob est lu à partir d’une URL donnée. Cette API est prise en charge à partir de la version 2020-04-08.

Les mises à jour partielles ne sont pas prises en charge avec Put Blob from URL ; le contenu d’un objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer des mises à jour partielles du contenu d’un objet blob de blocs à l’aide d’une URL source, utilisez l’API Put Block from URL conjointement avec Put Block List.

SyncUploadFromUriAsync(Uri, Boolean, CancellationToken)

L’opération Charger à partir de l’URI crée un objet blob de blocs où le contenu de l’objet blob est lu à partir d’une URL donnée. Cette API est prise en charge à partir de la version 2020-04-08.

Les mises à jour partielles ne sont pas prises en charge avec Put Blob from URL ; le contenu d’un objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer des mises à jour partielles du contenu d’un objet blob de blocs à l’aide d’une URL source, utilisez l’API Put Block from URL conjointement avec Put Block List.

Undelete(CancellationToken)

L’opération Undelete(CancellationToken) restaure le contenu et les métadonnées d’un objet blob supprimé de manière réversible et de tous les instantanés supprimés de manière réversible associés.

Pour plus d'informations, consultez la rubrique Annuler la suppression de l’objet blob.

(Hérité de BlobBaseClient)
UndeleteAsync(CancellationToken)

L’opération UndeleteAsync(CancellationToken) restaure le contenu et les métadonnées d’un objet blob supprimé de manière réversible et de tous les instantanés supprimés de manière réversible associés.

Pour plus d'informations, consultez la rubrique Annuler la suppression de l’objet blob.

(Hérité de BlobBaseClient)
Upload(Stream, BlobUploadOptions, CancellationToken)

L’opération Upload(Stream, BlobUploadOptions, CancellationToken) remplace le contenu de l’objet blob, créant un nouvel objet blob de blocs s’il n’en existe aucun. Le remplacement d’un objet blob de blocs existant remplace toutes les métadonnées existantes sur l’objet blob.

Définissez les conditions d’accès via Conditions pour éviter de remplacer les données existantes.

Les mises à jour partielles ne sont pas prises en charge par Upload(Stream, BlobUploadOptions, CancellationToken); le contenu de l'objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer une mise à jour partielle du contenu d’un objet blob de blocs, utilisez les Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) opérations et CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

Pour plus d'informations, consultez la rubrique Placez l’objet blob.

UploadAsync(Stream, BlobUploadOptions, CancellationToken)

L’opération UploadAsync(Stream, BlobUploadOptions, CancellationToken) remplace le contenu de l’objet blob, créant un nouvel objet blob de blocs s’il n’en existe aucun. Le remplacement d’un objet blob de blocs existant remplace toutes les métadonnées existantes sur l’objet blob.

Définissez les conditions d’accès via Conditions pour éviter de remplacer les données existantes.

Les mises à jour partielles ne sont pas prises en charge par UploadAsync(Stream, BlobUploadOptions, CancellationToken); le contenu de l'objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer une mise à jour partielle du contenu d’un objet blob de blocs, utilisez les Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) opérations et CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

Pour plus d'informations, consultez la rubrique Placez l’objet blob.

WithCustomerProvidedKey(Nullable<CustomerProvidedKey>)

Initialise une nouvelle instance de la BlockBlobClient classe avec une source identiqueUri, mais le spécifiécustomerProvidedKey.

WithEncryptionScope(String)

Initialise une nouvelle instance de la BlockBlobClient classe avec une source identiqueUri, mais le spécifiéencryptionScope.

WithSnapshot(String)

Initialise une nouvelle instance de la BlockBlobClient classe avec une source identiqueUri, mais l’horodatage spécifiésnapshot.

Pour plus d'informations, consultez la rubrique Créez un instantané d’un objet blob.

WithSnapshotCore(String)

Crée un instance de la BlockBlobClient classe avec une source identiqueUri, mais l’horodatage spécifiésnapshot.

WithVersion(String)

Initialise une nouvelle instance de la BlockBlobClient classe avec une source identiqueUri, mais l’horodatage spécifiéversionId.

Méthodes d’extension

GetBlobLeaseClient(BlobBaseClient, String)

Initialise une nouvelle instance de la classe BlobLeaseClient.

GetParentBlobContainerClient(BlobBaseClient)

Créez un BlobContainerClient qui pointe vers ce BlobBaseClientconteneur parent. Le nouveau BlockBlobClient utilise le même pipeline de stratégie de requête que le BlobBaseClient.

S’applique à