CloudBlob.DownloadToFileParallelAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Storage.Blob

Ensamblado:

Microsoft.Azure.Storage.Blob.dll

Paquete:

Microsoft.Azure.Storage.Blob v11.2.3

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.Task

Public 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 Task

Parámetros

path

String

Cadena que contiene la ruta de acceso al archivo de destino.

mode

FileMode

Valor FileMode de enumeración que determina cómo abrir o crear el archivo.

parallelIOCount

Int32

Número máximo de intervalos que se pueden descargar simultáneamente

rangeSizeInBytes

Nullable<Int64>

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.

length

Nullable<Int64>

Número de bytes que se van a descargar.

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

Task

Objeto Task que representa la operación asincrónica.

Atributos

DoesServiceRequestAttribute

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.

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.Task

Public Overridable Function DownloadToFileParallelAsync (path As String, mode As FileMode, parallelIOCount As Integer, rangeSizeInBytes As Nullable(Of Long), cancellationToken As CancellationToken) As Task

Parámetros

path

String

Cadena que contiene la ruta de acceso al archivo de destino.

mode

FileMode

Valor FileMode de enumeración que determina cómo abrir o crear el archivo.

parallelIOCount

Int32

Número máximo de intervalos que se pueden descargar simultáneamente.

rangeSizeInBytes

Nullable<Int64>

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

Task

Objeto Task que representa la operación asincrónica.

Atributos

DoesServiceRequestAttribute

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.

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.Task

Public Overridable Function DownloadToFileParallelAsync (path As String, mode As FileMode, parallelIOCount As Integer, rangeSizeInBytes As Nullable(Of Long)) As Task

Parámetros

path

String

Cadena que contiene la ruta de acceso al archivo de destino.

mode

FileMode

Valor FileMode de enumeración que determina cómo abrir o crear el archivo.

parallelIOCount

Int32

Número máximo de intervalos que se pueden descargar simultáneamente

rangeSizeInBytes

Nullable<Int64>

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

Task

Objeto Task que representa la operación asincrónica.

Atributos

DoesServiceRequestAttribute

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.