Storage Client Library for Windows Phone (Version 7.0)

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(
	bool createNew,
	CancellationToken cancellationToken
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual Task<CloudBlobStream^>^ OpenWriteAsync(
	bool createNew,
	CancellationToken cancellationToken
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract OpenWriteAsync : 
        createNew:bool *
        cancellationToken:CancellationToken -> Task<CloudBlobStream>
[<DoesServiceRequestAttribute>]
override OpenWriteAsync : 
        createNew:bool *
        cancellationToken:CancellationToken -> Task<CloudBlobStream>

VB

Copy Code

 

<DoesServiceRequestAttribute>
Public Overridable Function OpenWriteAsync (
	createNew As Boolean,
	cancellationToken As CancellationToken
) As Task(Of CloudBlobStream)

Parameters

createNew

Type: System.BooleanSystem::BooleanSystem.BooleanSystem.Boolean

Use true to create a new append blob or overwrite an existing one, false to append to an existing 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.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 FetchAttributesAsync 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
CloudAppendBlob Class
Microsoft.WindowsAzure.Storage.Blob Namespace

Return to top