CloudPageBlob.StartCopyFromBlob Method (CloudPageBlob, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)

Article
05/14/2014

Starts an operation to start copying another page blob's contents, properties, and metadata to this page blob.

Namespace: Microsoft.WindowsAzure.Storage.Blob
Assembly: Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)

Syntax

'Declaration
<DoesServiceRequestAttribute> _
Public Function StartCopyFromBlob ( _
    source As CloudPageBlob, _
    <OptionalAttribute> Optional sourceAccessCondition As AccessCondition = Nothing, _
    <OptionalAttribute> Optional destAccessCondition As AccessCondition = Nothing, _
    <OptionalAttribute> Optional options As BlobRequestOptions = Nothing, _
    <OptionalAttribute> Optional operationContext As OperationContext = Nothing _
) As String

[DoesServiceRequestAttribute] 
public string StartCopyFromBlob (
    CloudPageBlob source,
    [OptionalAttribute] AccessCondition sourceAccessCondition,
    [OptionalAttribute] AccessCondition destAccessCondition,
    [OptionalAttribute] BlobRequestOptions options,
    [OptionalAttribute] OperationContext operationContext
)

[DoesServiceRequestAttribute] 
public:
String^ StartCopyFromBlob (
    CloudPageBlob^ source, 
    [OptionalAttribute] AccessCondition^ sourceAccessCondition, 
    [OptionalAttribute] AccessCondition^ destAccessCondition, 
    [OptionalAttribute] BlobRequestOptions^ options, 
    [OptionalAttribute] OperationContext^ operationContext
)

Parameters

source
The Uri of the source blob.

sourceAccessCondition
An AccessCondition object that represents the access conditions for the source blob. If null, no condition is used.

destAccessCondition
An AccessCondition object that represents the access conditions for the destination blob. If null, no condition is used.

options
A BlobRequestOptions object that specifies additional options for the request. If null, default options are applied to the request.

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

Return Value

The copy ID associated with the copy operation.

Remarks

This method fetches the blob's ETag, last-modified time, and part of the copy state. The copy ID and copy status fields are fetched, and the rest of the copy state is cleared.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows 7 and Windows Server 2008