Initiates an asynchronous operation to write pages to a page blob.
Assembly: Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute] public virtual Task WritePagesAsync( Stream pageData, long startOffset, string contentMD5 )
public: [DoesServiceRequestAttribute] virtual Task^ WritePagesAsync( Stream^ pageData, long long startOffset, String^ contentMD5 )
[<DoesServiceRequestAttribute>] abstract WritePagesAsync : pageData:Stream * startOffset:int64 * contentMD5:string -> Task [<DoesServiceRequestAttribute>] override WritePagesAsync : pageData:Stream * startOffset:int64 * contentMD5:string -> Task
<DoesServiceRequestAttribute> Public Overridable Function WritePagesAsync ( pageData As Stream, startOffset As Long, contentMD5 As String ) As Task
Parameters
- pageData
-
Type:
System.IO.StreamSystem.IO::Stream^System.IO.StreamSystem.IO.Stream
A Stream object providing the page data.
- startOffset
-
Type:
System.Int64System::Int64System.Int64System.Int64
The offset at which to begin writing, in bytes. The offset must be a multiple of 512.
- contentMD5
-
Type:
System.StringSystem::String^System.StringSystem.String
An optional hash value used to ensure transactional integrity for the page. May be null or an empty string.
Return Value
Type: System.Threading.Tasks.TaskSystem.Threading.Tasks::Task^System.Threading.Tasks.TaskSystem.Threading.Tasks.TaskA Task object that represents the asynchronous operation.
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 P:BlobRequestOptions.UseTransactionalMd5Referenced topic's target id should not be empty. Article id: 978f823f-86e3-4c29-ac10-8c3b7fc78e60, link: P: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.