CloudBlockBlob.BeginPutBlock Method (String, Stream, String, AsyncCallback, Object)


Updated: December 20, 2016

Begins an asynchronous operation to upload a single block.

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

public virtual ICancellableAsyncResult BeginPutBlock(
	string blockId,
	Stream blockData,
	string contentMD5,
	AsyncCallback callback,
	object state


Type: System.String

A Base64-encoded string that identifies the block.

Type: System.IO.Stream

A Stream object that provides the data for the block.

Type: System.String

An optional hash value used to ensure transactional integrity for the block. May be null or an empty string.

Type: System.AsyncCallback

An AsyncCallback delegate that will receive notification when the asynchronous operation completes.

Type: System.Object

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

Return Value

Type: Microsoft.WindowsAzure.Storage.ICancellableAsyncResult

An ICancellableAsyncResult that references the asynchronous operation.

Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5 parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the P:BlobRequestOptions.UseTransactionalMd5 property is set to true and the contentMD5 parameter is set to null, then the client library will calculate the MD5 value internally.

Return to top