ICloudBlob.DownloadRangeToByteArrayAsync Method (Byte[], Int32, Nullable(Int64), Nullable(Int64), AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) (Microsoft.WindowsAzure.Storage.Blob)
From Microsoft Windows Azure Storage Blob
Initiates an asynchronous operation to download a range of bytes from a blob to a byte array.
Namespace:
Microsoft.WindowsAzure.Storage.Blob
Assembly:
Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
Task<int> DownloadRangeToByteArrayAsync(
byte[] target,
int index,
Nullable<long> blobOffset,
Nullable<long> length,
AccessCondition accessCondition,
BlobRequestOptions options,
OperationContext operationContext,
CancellationToken cancellationToken
)
C++
Task<int>^ DownloadRangeToByteArrayAsync(
array<unsigned char>^ target,
int index,
Nullable<long long> blobOffset,
Nullable<long long> length,
AccessCondition^ accessCondition,
BlobRequestOptions^ options,
OperationContext^ operationContext,
CancellationToken cancellationToken
)
abstract DownloadRangeToByteArrayAsync :
target:byte[] *
index:int *
blobOffset:Nullable<int64> *
length:Nullable<int64> *
accessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
cancellationToken:CancellationToken -> Task<int>
Function DownloadRangeToByteArrayAsync (
target As Byte(),
index As Integer,
blobOffset As Nullable(Of Long),
length As Nullable(Of Long),
accessCondition As AccessCondition,
options As BlobRequestOptions,
operationContext As OperationContext,
cancellationToken As CancellationToken
) As Task(Of Integer)
Parameters
- target
-
Type:
System.Byte[]array<System::Byte>^System.Byte[]System.Byte()
The target byte array.
- index
-
Type:
System.Int32System::Int32System.Int32System.Int32
The starting offset in the byte array.
- blobOffset
-
Type:
System.Nullable<Int64>System::Nullable<Int64>System.Nullable<Int64>System.Nullable(Of Int64)
The starting offset of the data range, in bytes.
- length
-
Type:
System.Nullable<Int64>System::Nullable<Int64>System.Nullable<Int64>System.Nullable(Of Int64)
The length of the data range, in bytes.
- accessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed.
- options
-
Type:
Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptionsMicrosoft.WindowsAzure.Storage.Blob::BlobRequestOptions^Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptionsMicrosoft.WindowsAzure.Storage.Blob.BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
-
Type:
Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage::OperationContext^Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage.OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
-
Type:
System.Threading.CancellationTokenSystem.Threading::CancellationTokenSystem.Threading.CancellationTokenSystem.Threading.CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Return Value
Type:
System.Threading.Tasks.Task<Int32>System.Threading.Tasks::Task<Int32>^System.Threading.Tasks.Task<Int32>System.Threading.Tasks.Task(Of Int32)A Task object of type int that represents the asynchronous operation.
See Also
DownloadRangeToByteArrayAsync Overload
ICloudBlob Interface
Microsoft.WindowsAzure.Storage.Blob Namespace
Return to top
Initiates an asynchronous operation to download a range of bytes from a blob to a byte array.
Syntax
Task<int> DownloadRangeToByteArrayAsync( byte[] target, int index, Nullable<long> blobOffset, Nullable<long> length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext, CancellationToken cancellationToken )
Task<int>^ DownloadRangeToByteArrayAsync( array<unsigned char>^ target, int index, Nullable<long long> blobOffset, Nullable<long long> length, AccessCondition^ accessCondition, BlobRequestOptions^ options, OperationContext^ operationContext, CancellationToken cancellationToken )
abstract DownloadRangeToByteArrayAsync :
target:byte[] *
index:int *
blobOffset:Nullable<int64> *
length:Nullable<int64> *
accessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
cancellationToken:CancellationToken -> Task<int>Function DownloadRangeToByteArrayAsync ( target As Byte(), index As Integer, blobOffset As Nullable(Of Long), length As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken ) As Task(Of Integer)
Parameters
- target
-
Type:
System.Byte[]array<System::Byte>^System.Byte[]System.Byte()
The target byte array.
- index
-
Type:
System.Int32System::Int32System.Int32System.Int32
The starting offset in the byte array.
- blobOffset
-
Type:
System.Nullable<Int64>System::Nullable<Int64>System.Nullable<Int64>System.Nullable(Of Int64)
The starting offset of the data range, in bytes.
- length
-
Type:
System.Nullable<Int64>System::Nullable<Int64>System.Nullable<Int64>System.Nullable(Of Int64)
The length of the data range, in bytes.
- accessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed.
- options
-
Type:
Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptionsMicrosoft.WindowsAzure.Storage.Blob::BlobRequestOptions^Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptionsMicrosoft.WindowsAzure.Storage.Blob.BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
-
Type:
Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage::OperationContext^Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage.OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
-
Type:
System.Threading.CancellationTokenSystem.Threading::CancellationTokenSystem.Threading.CancellationTokenSystem.Threading.CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Return Value
Type: System.Threading.Tasks.Task<Int32>System.Threading.Tasks::Task<Int32>^System.Threading.Tasks.Task<Int32>System.Threading.Tasks.Task(Of Int32)A Task object of type int that represents the asynchronous operation.
See Also
DownloadRangeToByteArrayAsync Overload
ICloudBlob Interface
Microsoft.WindowsAzure.Storage.Blob Namespace