CloudAppendBlob.OpenWriteAsync Method (Boolean, CancellationToken) (Microsoft.WindowsAzure.Storage.Blob)
From Microsoft Windows Azure 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
[DoesServiceRequestAttribute]
public virtual Task<CloudBlobStream> OpenWriteAsync(
bool createNew,
CancellationToken cancellationToken
)
C++public:
[DoesServiceRequestAttribute]
virtual Task<CloudBlobStream^>^ OpenWriteAsync(
bool createNew,
CancellationToken cancellationToken
)
[<DoesServiceRequestAttribute>]
abstract OpenWriteAsync :
createNew:bool *
cancellationToken:CancellationToken -> Task<CloudBlobStream>
[<DoesServiceRequestAttribute>]
override OpenWriteAsync :
createNew:bool *
cancellationToken:CancellationToken -> Task<CloudBlobStream>
<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.
Return to top
Initiates an asynchronous operation to open a stream for writing to the blob.
Syntax
[DoesServiceRequestAttribute] public virtual Task<CloudBlobStream> OpenWriteAsync( bool createNew, CancellationToken cancellationToken )
public: [DoesServiceRequestAttribute] virtual Task<CloudBlobStream^>^ OpenWriteAsync( bool createNew, CancellationToken cancellationToken )
[<DoesServiceRequestAttribute>] abstract OpenWriteAsync : createNew:bool * cancellationToken:CancellationToken -> Task<CloudBlobStream> [<DoesServiceRequestAttribute>] override OpenWriteAsync : createNew:bool * cancellationToken:CancellationToken -> Task<CloudBlobStream>
<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.