CloudAppendBlob.UploadFromByteArrayAsync Method (Byte[], Int32, Int32, CancellationToken) (Microsoft.WindowsAzure.Storage.Blob)

Initiates an asynchronous operation to upload the contents of a byte array to an append blob. If the blob already exists, it will be overwritten. Recommended only for single-writer scenarios.

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

Syntax

C#

Copy Code

 

[DoesServiceRequestAttribute]
public virtual Task UploadFromByteArrayAsync(
	byte[] buffer,
	int index,
	int count,
	CancellationToken cancellationToken
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual Task^ UploadFromByteArrayAsync(
	array<unsigned char>^ buffer,
	int index,
	int count,
	CancellationToken cancellationToken
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract UploadFromByteArrayAsync : 
        buffer:byte[] *
        index:int *
        count:int *
        cancellationToken:CancellationToken -> Task
[<DoesServiceRequestAttribute>]
override UploadFromByteArrayAsync : 
        buffer:byte[] *
        index:int *
        count:int *
        cancellationToken:CancellationToken -> Task

VB

Copy Code

 

<DoesServiceRequestAttribute>
Public Overridable Function UploadFromByteArrayAsync (
	buffer As Byte(),
	index As Integer,
	count As Integer,
	cancellationToken As CancellationToken
) As Task

Parameters

buffer

Type: System.Byte[]array<System::Byte>^System.Byte[]System.Byte()

An array of bytes.

index

Type: System.Int32System::Int32System.Int32System.Int32

The zero-based byte offset in buffer at which to begin uploading bytes to the blob.

count

Type: System.Int32System::Int32System.Int32System.Int32

The number of bytes to be written to the blob.

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.TaskSystem.Threading.Tasks::Task^System.Threading.Tasks.TaskSystem.Threading.Tasks.Task

A Task object that represents the asynchronous operation.

Implements

ICloudBlob.::..UploadFromByteArrayAsync(Byte[], Int32, Int32, CancellationToken)(array<Byte>^, Int32, Int32, CancellationToken)(Byte[], Int32, Int32, CancellationToken)(Byte(), Int32, Int32, CancellationToken)

Remarks

Use this method only in single-writer scenarios. Internally, this method uses the append-offset conditional header to avoid duplicate blocks, which may cause problems in multiple-writer scenarios. To append data to an append blob that already exists, see AppendFromByteArrayAsync.

See Also

UploadFromByteArrayAsync Overload
CloudAppendBlob Class
Microsoft.WindowsAzure.Storage.Blob Namespace

Return to top