CloudPageBlob.OpenWriteAsync Method (Nullable(Int64), AccessCondition, BlobRequestOptions, OperationContext) (Microsoft.WindowsAzure.Storage.Blob)

Initiates an asynchronous operation to open a stream for writing to the blob.

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

Syntax

C#

Copy Code

 

[DoesServiceRequestAttribute]
public virtual Task<CloudBlobStream> OpenWriteAsync(
	Nullable<long> size,
	AccessCondition accessCondition,
	BlobRequestOptions options,
	OperationContext operationContext
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual Task<CloudBlobStream^>^ OpenWriteAsync(
	Nullable<long long> size,
	AccessCondition^ accessCondition,
	BlobRequestOptions^ options,
	OperationContext^ operationContext
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract OpenWriteAsync : 
        size:Nullable<int64> *
        accessCondition:AccessCondition *
        options:BlobRequestOptions *
        operationContext:OperationContext -> Task<CloudBlobStream>
[<DoesServiceRequestAttribute>]
override OpenWriteAsync : 
        size:Nullable<int64> *
        accessCondition:AccessCondition *
        options:BlobRequestOptions *
        operationContext:OperationContext -> Task<CloudBlobStream>

VB

Copy Code

 

<DoesServiceRequestAttribute>
Public Overridable Function OpenWriteAsync (
	size As Nullable(Of Long),
	accessCondition As AccessCondition,
	options As BlobRequestOptions,
	operationContext As OperationContext
) As Task(Of CloudBlobStream)

Parameters

size

Type: System.Nullable<Int64>System::Nullable<Int64>System.Nullable<Int64>System.Nullable(Of Int64)

The size of the page blob, in bytes. The size must be a multiple of 512. If null, the page blob must already exist.

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.

Return Value

Type: System.Threading.Tasks.Task<CloudBlobStream>System.Threading.Tasks::Task<CloudBlobStream^>^System.Threading.Tasks.Task<CloudBlobStream>System.Threading.Tasks.Task(Of CloudBlobStream)

A Task<TResult><TResult><'TResult>(Of TResult) object of type CloudBlobStream that represents the asynchronous operation.

Remarks

Note that this method always makes a call to the Referenced topic '96b35858-1dc8-463c-86fd-152b3890b6bc' is not in the TOC. method under the covers.

Set the StreamWriteSizeInBytesStreamWriteSizeInBytesStreamWriteSizeInBytesStreamWriteSizeInBytes property before calling this method to specify the block size to write, in bytes, ranging from between 16 KB and 4 MB inclusive.

See Also

OpenWriteAsync Overload
CloudPageBlob Class
Microsoft.WindowsAzure.Storage.Blob Namespace

Return to top