CloudFile.BeginDownloadRangeToByteArray Method (Byte[], Int32, Nullable(Int64), Nullable(Int64), AccessCondition, FileRequestOptions, OperationContext, AsyncCallback, Object) (Microsoft.WindowsAzure.Storage.File)

Begins an asynchronous operation to download the contents of a file to a byte array.

Namespace:   Microsoft.WindowsAzure.Storage.File
Assembly:  Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)

Syntax

C#

Copy Code

 

[DoesServiceRequestAttribute]
public virtual ICancellableAsyncResult BeginDownloadRangeToByteArray(
	byte[] target,
	int index,
	Nullable<long> fileOffset,
	Nullable<long> length,
	AccessCondition accessCondition,
	FileRequestOptions options,
	OperationContext operationContext,
	AsyncCallback callback,
	object state
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual ICancellableAsyncResult^ BeginDownloadRangeToByteArray(
	array<unsigned char>^ target,
	int index,
	Nullable<long long> fileOffset,
	Nullable<long long> length,
	AccessCondition^ accessCondition,
	FileRequestOptions^ options,
	OperationContext^ operationContext,
	AsyncCallback^ callback,
	Object^ state
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract BeginDownloadRangeToByteArray : 
        target:byte[] *
        index:int *
        fileOffset:Nullable<int64> *
        length:Nullable<int64> *
        accessCondition:AccessCondition *
        options:FileRequestOptions *
        operationContext:OperationContext *
        callback:AsyncCallback *
        state:Object -> ICancellableAsyncResult
[<DoesServiceRequestAttribute>]
override BeginDownloadRangeToByteArray : 
        target:byte[] *
        index:int *
        fileOffset:Nullable<int64> *
        length:Nullable<int64> *
        accessCondition:AccessCondition *
        options:FileRequestOptions *
        operationContext:OperationContext *
        callback:AsyncCallback *
        state:Object -> ICancellableAsyncResult

VB

Copy Code

 

<DoesServiceRequestAttribute>
Public Overridable Function BeginDownloadRangeToByteArray (
	target As Byte(),
	index As Integer,
	fileOffset As Nullable(Of Long),
	length As Nullable(Of Long),
	accessCondition As AccessCondition,
	options As FileRequestOptions,
	operationContext As OperationContext,
	callback As AsyncCallback,
	state As Object
) As ICancellableAsyncResult

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.

fileOffset

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 to download from the file, in bytes.

accessCondition

Type: Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition

An AccessCondition object that represents the access conditions for the file.

options

Type: Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File::FileRequestOptions^Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File.FileRequestOptions

A FileRequestOptions 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.

callback

Type: System.AsyncCallbackSystem::AsyncCallback^System.AsyncCallbackSystem.AsyncCallback

The callback delegate that will receive notification when the asynchronous operation completes.

state

Type: System.ObjectSystem::Object^System.ObjectSystem.Object

A user-defined object that will be passed to the callback delegate.

Return Value

Type: Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage::ICancellableAsyncResult^Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage.ICancellableAsyncResult

An ICancellableAsyncResult that references the asynchronous operation.

See Also

BeginDownloadRangeToByteArray Overload
CloudFile Class
Microsoft.WindowsAzure.Storage.File Namespace

Return to top