Storage Client Library for Windows Phone (Version 7.0)

Microsoft Windows Azure Storage Blob

Initiates an asynchronous operation to upload a single block.

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

Syntax

 
[DoesServiceRequestAttribute]
public virtual Task PutBlockAsync(
	string blockId,
	Stream blockData,
	string contentMD5,
	AccessCondition accessCondition,
	BlobRequestOptions options,
	OperationContext operationContext
)
 
public:
[DoesServiceRequestAttribute]
virtual Task^ PutBlockAsync(
	String^ blockId,
	Stream^ blockData,
	String^ contentMD5,
	AccessCondition^ accessCondition,
	BlobRequestOptions^ options,
	OperationContext^ operationContext
)
 
[<DoesServiceRequestAttribute>]
abstract PutBlockAsync : 
        blockId:string *
        blockData:Stream *
        contentMD5:string *
        accessCondition:AccessCondition *
        options:BlobRequestOptions *
        operationContext:OperationContext -> Task
[<DoesServiceRequestAttribute>]
override PutBlockAsync : 
        blockId:string *
        blockData:Stream *
        contentMD5:string *
        accessCondition:AccessCondition *
        options:BlobRequestOptions *
        operationContext:OperationContext -> Task
 
<DoesServiceRequestAttribute>
Public Overridable Function PutBlockAsync (
	blockId As String,
	blockData As Stream,
	contentMD5 As String,
	accessCondition As AccessCondition,
	options As BlobRequestOptions,
	operationContext As OperationContext
) As Task

Parameters

blockId
Type: System.StringSystem::String^System.StringSystem.String

A Base64-encoded string that identifies the block.

blockData
Type: System.IO.StreamSystem.IO::Stream^System.IO.StreamSystem.IO.Stream

A Stream object that provides the data for the block.

contentMD5
Type: System.StringSystem::String^System.StringSystem.String

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

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. If null, no condition is used.

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.

Remarks

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.UseTransactionalMd5Referenced topic's target id should not be empty. Article id: 151a595a-d6ea-42b1-9a19-bf00fa62cff2, link: 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