CloudAppendBlob.BeginOpenWrite Method (Boolean, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) (Microsoft.WindowsAzure.Storage.Blob)
From Microsoft Windows Azure Storage Blob
Begins 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 ICancellableAsyncResult BeginOpenWrite(
bool createNew,
AccessCondition accessCondition,
BlobRequestOptions options,
OperationContext operationContext,
AsyncCallback callback,
object state
)
C++public:
[DoesServiceRequestAttribute]
virtual ICancellableAsyncResult^ BeginOpenWrite(
bool createNew,
AccessCondition^ accessCondition,
BlobRequestOptions^ options,
OperationContext^ operationContext,
AsyncCallback^ callback,
Object^ state
)
[<DoesServiceRequestAttribute>]
abstract BeginOpenWrite :
createNew:bool *
accessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
callback:AsyncCallback *
state:Object -> ICancellableAsyncResult
[<DoesServiceRequestAttribute>]
override BeginOpenWrite :
createNew:bool *
accessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
callback:AsyncCallback *
state:Object -> ICancellableAsyncResult
<DoesServiceRequestAttribute>
Public Overridable Function BeginOpenWrite (
createNew As Boolean,
accessCondition As AccessCondition,
options As BlobRequestOptions,
operationContext As OperationContext,
callback As AsyncCallback,
state As Object
) As ICancellableAsyncResult
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.
- 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.
- callback
-
Type:
System.AsyncCallbackSystem::AsyncCallback^System.AsyncCallbackSystem.AsyncCallback
An AsyncCallback delegate that will receive notification when the asynchronous operation completes.
- state
-
Type:
System.ObjectSystem::Object^System.ObjectSystem.Object
A user-defined object that will be passed to the callback delegate.
Return Value
Type:
Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage::ICancellableAsyncResult^Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage.ICancellableAsyncResultAn ICancellableAsyncResult that references the asynchronous operation.
Remarks
Note that this method always makes a call to the BeginFetchAttributes 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.
If you have a single-writer scenario, see AbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetry to determine whether setting this flag to true is acceptable for your scenario.
Return to top
Begins an asynchronous operation to open a stream for writing to the blob.
Syntax
[DoesServiceRequestAttribute] public virtual ICancellableAsyncResult BeginOpenWrite( bool createNew, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext, AsyncCallback callback, object state )
public: [DoesServiceRequestAttribute] virtual ICancellableAsyncResult^ BeginOpenWrite( bool createNew, AccessCondition^ accessCondition, BlobRequestOptions^ options, OperationContext^ operationContext, AsyncCallback^ callback, Object^ state )
[<DoesServiceRequestAttribute>] abstract BeginOpenWrite : createNew:bool * accessCondition:AccessCondition * options:BlobRequestOptions * operationContext:OperationContext * callback:AsyncCallback * state:Object -> ICancellableAsyncResult [<DoesServiceRequestAttribute>] override BeginOpenWrite : createNew:bool * accessCondition:AccessCondition * options:BlobRequestOptions * operationContext:OperationContext * callback:AsyncCallback * state:Object -> ICancellableAsyncResult
<DoesServiceRequestAttribute> Public Overridable Function BeginOpenWrite ( createNew As Boolean, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, callback As AsyncCallback, state As Object ) As ICancellableAsyncResult
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.
- 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.
- callback
-
Type:
System.AsyncCallbackSystem::AsyncCallback^System.AsyncCallbackSystem.AsyncCallback
An AsyncCallback delegate that will receive notification when the asynchronous operation completes.
- state
-
Type:
System.ObjectSystem::Object^System.ObjectSystem.Object
A user-defined object that will be passed to the callback delegate.
Return Value
Type: Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage::ICancellableAsyncResult^Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage.ICancellableAsyncResultAn ICancellableAsyncResult that references the asynchronous operation.
Remarks
Note that this method always makes a call to the BeginFetchAttributes 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. If you have a single-writer scenario, see AbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetry to determine whether setting this flag to true is acceptable for your scenario.