Cloud​Page​Blob.​Write​Pages​Async Method

Definition

Overloads

Write​Pages​Async(​Stream, ​Int64, ​String, ​Access​Condition, ​Blob​Request​Options, ​Operation​Context)

Initiates an asynchronous operation to write pages to a page blob.

Write​Pages​Async(​Stream, ​Int64, ​String)

Initiates an asynchronous operation to write pages to a page blob.

Write​Pages​Async(​Stream, ​Int64, ​String, ​Cancellation​Token)

Initiates an asynchronous operation to write pages to a page blob.

Write​Pages​Async(​Stream, ​Int64, ​String, ​Access​Condition, ​Blob​Request​Options, ​Operation​Context, ​Cancellation​Token)

Initiates an asynchronous operation to write pages to a page blob.

WritePagesAsync(Stream, Int64, String, AccessCondition, BlobRequestOptions, OperationContext)

Initiates an asynchronous operation to write pages to a page blob.

[Microsoft.WindowsAzure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, string contentMD5, Microsoft.WindowsAzure.Storage.AccessCondition accessCondition, Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptions options, Microsoft.WindowsAzure.Storage.OperationContext operationContext);
Parameters
pageData
Stream

A Stream object providing the page data.

startOffset
Int64

The offset at which to begin writing, in bytes. The offset must be a multiple of 512.

contentMD5
String

An optional hash value used to ensure transactional integrity for the page. May be null or an empty string.

accessCondition
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
BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext
OperationContext

An OperationContext object that represents the context for the current operation.

Returns

A Task object that represents the asynchronous operation.

Attributes

Remarks

Clients may send the Content-MD5 header for a given Write Pages operation as a means to ensure transactional integrity over the wire. The contentMD5 parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true and the contentMD5 parameter is set to null, then the client library will calculate the MD5 value internally.

WritePagesAsync(Stream, Int64, String)

Initiates an asynchronous operation to write pages to a page blob.

[Microsoft.WindowsAzure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, string contentMD5);
Parameters
pageData
Stream

A Stream object providing the page data.

startOffset
Int64

The offset at which to begin writing, in bytes. The offset must be a multiple of 512.

contentMD5
String

An optional hash value used to ensure transactional integrity for the page. May be null or an empty string.

Returns

A Task object that represents the asynchronous operation.

Attributes

Remarks

Clients may send the Content-MD5 header for a given Write Pages operation as a means to ensure transactional integrity over the wire. The contentMD5 parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true and the contentMD5 parameter is set to null, then the client library will calculate the MD5 value internally.

WritePagesAsync(Stream, Int64, String, CancellationToken)

Initiates an asynchronous operation to write pages to a page blob.

[Microsoft.WindowsAzure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, string contentMD5, System.Threading.CancellationToken cancellationToken);
Parameters
pageData
Stream

A Stream object providing the page data.

startOffset
Int64

The offset at which to begin writing, in bytes. The offset must be a multiple of 512.

contentMD5
String

An optional hash value used to ensure transactional integrity for the page. May be null or an empty string.

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task object that represents the asynchronous operation.

Attributes

Remarks

Clients may send the Content-MD5 header for a given Write Pages operation as a means to ensure transactional integrity over the wire. The contentMD5 parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true and the contentMD5 parameter is set to null, then the client library will calculate the MD5 value internally.

WritePagesAsync(Stream, Int64, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to write pages to a page blob.

[Microsoft.WindowsAzure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task WritePagesAsync (System.IO.Stream pageData, long startOffset, string contentMD5, Microsoft.WindowsAzure.Storage.AccessCondition accessCondition, Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptions options, Microsoft.WindowsAzure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
Parameters
pageData
Stream

A Stream object providing the page data.

startOffset
Int64

The offset at which to begin writing, in bytes. The offset must be a multiple of 512.

contentMD5
String

An optional hash value used to ensure transactional integrity for the page. May be null or an empty string.

accessCondition
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
BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext
OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken
CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

A Task object that represents the asynchronous operation.

Attributes

Remarks

Clients may send the Content-MD5 header for a given Write Pages operation as a means to ensure transactional integrity over the wire. The contentMD5 parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true and the contentMD5 parameter is set to null, then the client library will calculate the MD5 value internally.