CloudBlob.DownloadToFileParallelAsync 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
| DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, Int64, Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) |
Lance une opération asynchrone pour télécharger le contenu d’un objet blob dans un fichier en effectuant des requêtes parallèles. |
| DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, CancellationToken) |
Lance une opération asynchrone pour télécharger le contenu d’un objet blob dans un fichier en effectuant des requêtes parallèles. |
| DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>) |
Lance une opération asynchrone pour télécharger le contenu d’un objet blob dans un fichier en effectuant des requêtes parallèles. |
DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, Int64, Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Lance une opération asynchrone pour télécharger le contenu d’un objet blob dans un fichier en effectuant des requêtes parallèles.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task DownloadToFileParallelAsync (string path, System.IO.FileMode mode, int parallelIOCount, long? rangeSizeInBytes, long offset, long? length, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member DownloadToFileParallelAsync : string * System.IO.FileMode * int * Nullable<int64> * int64 * Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DownloadToFileParallelAsync : string * System.IO.FileMode * int * Nullable<int64> * int64 * Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function DownloadToFileParallelAsync (path As String, mode As FileMode, parallelIOCount As Integer, rangeSizeInBytes As Nullable(Of Long), offset As Long, length As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As TaskParamètres
- path
- String
Chaîne contenant le chemin d’accès au fichier cible.
- parallelIOCount
- Int32
Nombre maximal de plages pouvant être téléchargées simultanément
Taille de chaque plage individuelle en octets qui est en cours de chargement en parallèle. La taille de la plage doit être un multiple de 4 Ko et un minimum de 4 Mo. Si aucune valeur n’est transmise, la valeur par défaut est de 16 Mo ou de 4 Mo si MD5 transactionnel est activé.
- offset
- Int64
Décalage de l’objet blob.
- accessCondition
- AccessCondition
Objet AccessCondition qui représente la condition qui doit être remplie pour que la demande continue.
- options
- BlobRequestOptions
Objet BlobRequestOptions qui spécifie les options supplémentaires de la demande.
- operationContext
- OperationContext
Objet OperationContext qui représente le contexte de l'opération actuelle.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant qu'une tâche se termine.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
ParallelIOCount et rangeSizeInBytes doivent être ajustés en fonction du processeur, de la mémoire et de la bande passante. Cette API ne doit être utilisée que pour les téléchargements plus volumineux, car une demande de HEAD est effectuée avant le téléchargement des données. Pour les objets blob plus petits, utilisez DownloadToFileAsync(). Pour obtenir les meilleures performances, il est recommandé d’essayer plusieurs valeurs et de mesurer le débit. Un point de départ consiste à définir parallelIOCount sur le nombre de processeurs. Ensuite, ajustez la plageSizeInBytes afin que la plage de temps parallelIOCountSizeInBytes corresponde à la quantité de mémoire que vous souhaitez que le processus consomme.
S’applique à
DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, CancellationToken)
Lance une opération asynchrone pour télécharger le contenu d’un objet blob dans un fichier en effectuant des requêtes parallèles.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task DownloadToFileParallelAsync (string path, System.IO.FileMode mode, int parallelIOCount, long? rangeSizeInBytes, System.Threading.CancellationToken cancellationToken);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member DownloadToFileParallelAsync : string * System.IO.FileMode * int * Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DownloadToFileParallelAsync : string * System.IO.FileMode * int * Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function DownloadToFileParallelAsync (path As String, mode As FileMode, parallelIOCount As Integer, rangeSizeInBytes As Nullable(Of Long), cancellationToken As CancellationToken) As TaskParamètres
- path
- String
Chaîne contenant le chemin d’accès au fichier cible.
- parallelIOCount
- Int32
Nombre maximal de plages pouvant être téléchargées simultanément.
Taille de chaque plage individuelle en octets qui est en cours de chargement en parallèle. La taille de la plage doit être un multiple de 4 Ko et un minimum de 4 Mo. Si aucune valeur n’est transmise, une valeur par défaut de 16 Mo est utilisée ou de 4 Mo si MD5 transactionnel est activé.
- cancellationToken
- CancellationToken
CancellationToken à observer en attendant qu'une tâche se termine.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Exemples
// When calling the DownloadToFileParallelAsync API,
// the parallelIOCount variable represents how many ranges can be downloaded concurrently. If the
// parallel I/O count reaches this threshold, no more further requests are made until one range completes.
// The rangeSizeInBytes represents the size of each individual range that is being dowloaded in parallel.
// Passing a cancellation token is advised since for certain network errors, this code will continue to retry indefintitely.
int parallelIOCount = 16;
long rangeSizeInBytes = 16*Constants.MB;
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
await blob.DownloadToFileParallelAsync(outputFileName, FileMode.Create, parallelIOCount, rangeSizeInBytes, cancellationTokenSource.Token);
Remarques
ParallelIOCount et rangeSizeInBytes doivent être ajustés en fonction du processeur, de la mémoire et de la bande passante. Cette API ne doit être utilisée que pour les téléchargements plus volumineux, car une demande de HEAD est effectuée avant le téléchargement des données. Pour les objets blob plus petits, utilisez DownloadToFileAsync(). Pour obtenir les meilleures performances, il est recommandé d’essayer plusieurs valeurs et de mesurer le débit. Un point de départ consiste à définir parallelIOCount sur le nombre de processeurs. Ensuite, ajustez la plageSizeInBytes afin que la plage de temps parallelIOCountSizeInBytes corresponde à la quantité de mémoire que vous souhaitez que le processus consomme.
S’applique à
DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>)
Lance une opération asynchrone pour télécharger le contenu d’un objet blob dans un fichier en effectuant des requêtes parallèles.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task DownloadToFileParallelAsync (string path, System.IO.FileMode mode, int parallelIOCount, long? rangeSizeInBytes);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member DownloadToFileParallelAsync : string * System.IO.FileMode * int * Nullable<int64> -> System.Threading.Tasks.Task
override this.DownloadToFileParallelAsync : string * System.IO.FileMode * int * Nullable<int64> -> System.Threading.Tasks.TaskPublic Overridable Function DownloadToFileParallelAsync (path As String, mode As FileMode, parallelIOCount As Integer, rangeSizeInBytes As Nullable(Of Long)) As TaskParamètres
- path
- String
Chaîne contenant le chemin d’accès au fichier cible.
- parallelIOCount
- Int32
Nombre maximal de plages pouvant être téléchargées simultanément
Taille de chaque plage individuelle en octets qui est en cours de chargement en parallèle. La taille de la plage doit être un multiple de 4 Ko et un minimum de 4 Mo. Si aucune valeur n’est transmise, une valeur par défaut de 16 Mo est utilisée ou de 4 Mo si MD5 transactionnel est activé.
Retours
Objet Task qui représente l’opération asynchrone.
- Attributs
Remarques
ParallelIOCount et rangeSizeInBytes doivent être ajustés en fonction du processeur, de la mémoire et de la bande passante. Cette API ne doit être utilisée que pour les téléchargements plus volumineux, car une demande de HEAD est effectuée avant le téléchargement des données. Pour les objets blob plus petits, utilisez DownloadToFileAsync(). Pour obtenir les meilleures performances, il est recommandé d’essayer plusieurs valeurs et de mesurer le débit. Un point de départ consiste à définir parallelIOCount sur le nombre de processeurs. Ensuite, ajustez la plageSizeInBytes afin que la plage de temps parallelIOCountSizeInBytes corresponde à la quantité de mémoire que vous souhaitez que le processus consomme.
S’applique à
Azure SDK for .NET