CloudPageBlob.BeginClearPages Method (Int64, Int64, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) (Microsoft.WindowsAzure.Storage.Blob)
From Microsoft Windows Azure Storage Blob
Begins an asynchronous operation to clear pages from a page blob.
Namespace:
Microsoft.WindowsAzure.Storage.Blob
Assembly:
Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute]
public virtual ICancellableAsyncResult BeginClearPages(
long startOffset,
long length,
AccessCondition accessCondition,
BlobRequestOptions options,
OperationContext operationContext,
AsyncCallback callback,
object state
)
C++
public:
[DoesServiceRequestAttribute]
virtual ICancellableAsyncResult^ BeginClearPages(
long long startOffset,
long long length,
AccessCondition^ accessCondition,
BlobRequestOptions^ options,
OperationContext^ operationContext,
AsyncCallback^ callback,
Object^ state
)
[<DoesServiceRequestAttribute>]
abstract BeginClearPages :
startOffset:int64 *
length:int64 *
accessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
callback:AsyncCallback *
state:Object -> ICancellableAsyncResult
[<DoesServiceRequestAttribute>]
override BeginClearPages :
startOffset:int64 *
length:int64 *
accessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
callback:AsyncCallback *
state:Object -> ICancellableAsyncResult
<DoesServiceRequestAttribute>
Public Overridable Function BeginClearPages (
startOffset As Long,
length As Long,
accessCondition As AccessCondition,
options As BlobRequestOptions,
operationContext As OperationContext,
callback As AsyncCallback,
state As Object
) As ICancellableAsyncResult
Parameters
- startOffset
-
Type:
System.Int64System::Int64System.Int64System.Int64
The offset at which to begin clearing pages, in bytes. The offset must be a multiple of 512.
- length
-
Type:
System.Int64System::Int64System.Int64System.Int64
The length of the data range to be cleared, in bytes. The length must be a multiple of 512.
- 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.
Return to top
Begins an asynchronous operation to clear pages from a page blob.
Syntax
[DoesServiceRequestAttribute] public virtual ICancellableAsyncResult BeginClearPages( long startOffset, long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext, AsyncCallback callback, object state )
public: [DoesServiceRequestAttribute] virtual ICancellableAsyncResult^ BeginClearPages( long long startOffset, long long length, AccessCondition^ accessCondition, BlobRequestOptions^ options, OperationContext^ operationContext, AsyncCallback^ callback, Object^ state )
[<DoesServiceRequestAttribute>] abstract BeginClearPages : startOffset:int64 * length:int64 * accessCondition:AccessCondition * options:BlobRequestOptions * operationContext:OperationContext * callback:AsyncCallback * state:Object -> ICancellableAsyncResult [<DoesServiceRequestAttribute>] override BeginClearPages : startOffset:int64 * length:int64 * accessCondition:AccessCondition * options:BlobRequestOptions * operationContext:OperationContext * callback:AsyncCallback * state:Object -> ICancellableAsyncResult
<DoesServiceRequestAttribute> Public Overridable Function BeginClearPages ( startOffset As Long, length As Long, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, callback As AsyncCallback, state As Object ) As ICancellableAsyncResult
Parameters
- startOffset
-
Type:
System.Int64System::Int64System.Int64System.Int64
The offset at which to begin clearing pages, in bytes. The offset must be a multiple of 512.
- length
-
Type:
System.Int64System::Int64System.Int64System.Int64
The length of the data range to be cleared, in bytes. The length must be a multiple of 512.
- 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.