CloudBlob.DownloadToFileParallelAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, Int64, Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) |
Inicia una operación asincrónica para descargar el contenido de un blob en un archivo realizando solicitudes paralelas. |
| DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, CancellationToken) |
Inicia una operación asincrónica para descargar el contenido de un blob en un archivo realizando solicitudes paralelas. |
| DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>) |
Inicia una operación asincrónica para descargar el contenido de un blob en un archivo realizando solicitudes paralelas. |
DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, Int64, Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia una operación asincrónica para descargar el contenido de un blob en un archivo realizando solicitudes paralelas.
[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 TaskParámetros
- path
- String
Cadena que contiene la ruta de acceso al archivo de destino.
- parallelIOCount
- Int32
Número máximo de intervalos que se pueden descargar simultáneamente
Tamaño de cada intervalo individual en bytes que se carga en paralelo. El tamaño del intervalo debe ser un múltiplo de 4 KB y un mínimo de 4 MB. Si no se pasa ningún valor predeterminado de 16 MB o 4 MB si está habilitado MD5 transaccional.
- offset
- Int64
Desplazamiento del blob.
- accessCondition
- AccessCondition
Un objeto AccessCondition que representa la condición que debe cumplirse para continuar con la solicitud.
- options
- BlobRequestOptions
Objeto BlobRequestOptions que especifica opciones adicionales para la solicitud.
- operationContext
- OperationContext
Objeto OperationContext que representa el contexto para la operación actual.
- cancellationToken
- CancellationToken
Un CancellationToken que se observará mientras se espera a que se complete la tarea.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
ParallelIOCount y rangeSizeInBytes deben ajustarse en función de la CPU, la memoria y el ancho de banda. Esta API solo se debe usar para descargas más grandes, ya que se realiza una solicitud HEAD antes de descargar los datos. Para blobs más pequeños, use DownloadToFileAsync(). Para obtener el mejor rendimiento, se recomienda probar varios valores y medir el rendimiento. Un lugar de inicio sería establecer parallelIOCount en el número de CPU. A continuación, ajuste el rangeSizeInBytes para que parallelIOCount times rangeSizeInBytes sea igual a la cantidad de memoria que desea que consuma el proceso.
Se aplica a
DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>, CancellationToken)
Inicia una operación asincrónica para descargar el contenido de un blob en un archivo realizando solicitudes paralelas.
[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 TaskParámetros
- path
- String
Cadena que contiene la ruta de acceso al archivo de destino.
- parallelIOCount
- Int32
Número máximo de intervalos que se pueden descargar simultáneamente.
Tamaño de cada intervalo individual en bytes que se carga en paralelo. El tamaño del intervalo debe ser un múltiplo de 4 KB y un mínimo de 4 MB. Si no se pasa ningún valor, se usa un valor predeterminado de 16 MB o 4 MB si está habilitado MD5 transaccional.
- cancellationToken
- CancellationToken
Un CancellationToken que se observará mientras se espera a que se complete la tarea.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Ejemplos
// 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);
Comentarios
ParallelIOCount y rangeSizeInBytes deben ajustarse en función de la CPU, la memoria y el ancho de banda. Esta API solo se debe usar para descargas más grandes, ya que se realiza una solicitud HEAD antes de descargar los datos. Para blobs más pequeños, use DownloadToFileAsync(). Para obtener el mejor rendimiento, se recomienda probar varios valores y medir el rendimiento. Un lugar de inicio sería establecer parallelIOCount en el número de CPU. A continuación, ajuste el rangeSizeInBytes para que parallelIOCount times rangeSizeInBytes sea igual a la cantidad de memoria que desea que consuma el proceso.
Se aplica a
DownloadToFileParallelAsync(String, FileMode, Int32, Nullable<Int64>)
Inicia una operación asincrónica para descargar el contenido de un blob en un archivo realizando solicitudes paralelas.
[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 TaskParámetros
- path
- String
Cadena que contiene la ruta de acceso al archivo de destino.
- parallelIOCount
- Int32
Número máximo de intervalos que se pueden descargar simultáneamente
Tamaño de cada intervalo individual en bytes que se carga en paralelo. El tamaño del intervalo debe ser un múltiplo de 4 KB y un mínimo de 4 MB. Si no se pasa ningún valor, se usa un valor predeterminado de 16 MB o 4 MB si está habilitado MD5 transaccional.
Devoluciones
Objeto Task que representa la operación asincrónica.
- Atributos
Comentarios
ParallelIOCount y rangeSizeInBytes deben ajustarse en función de la CPU, la memoria y el ancho de banda. Esta API solo se debe usar para descargas más grandes, ya que se realiza una solicitud HEAD antes de descargar los datos. Para blobs más pequeños, use DownloadToFileAsync(). Para obtener el mejor rendimiento, se recomienda probar varios valores y medir el rendimiento. Un lugar de inicio sería establecer parallelIOCount en el número de CPU. A continuación, ajuste el rangeSizeInBytes para que parallelIOCount times rangeSizeInBytes sea igual a la cantidad de memoria que desea que consuma el proceso.
Se aplica a
Azure SDK for .NET