CloudBlockBlob.StartCopyFromBlobAsync Method (Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)

Windows Runtime Azure Storage Client Library

Requests that the service start to copy a blob's contents, properties, and metadata to a new blob.

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

Usage

Visual Basic
Dim instance As CloudBlockBlob
Dim source As Uri
Dim sourceAccessCondition As AccessCondition
Dim destAccessCondition As AccessCondition
Dim options As BlobRequestOptions
Dim operationContext As OperationContext
Dim returnValue As IAsyncOperation(Of String)

returnValue = instance.StartCopyFromBlobAsync(source, sourceAccessCondition, destAccessCondition, options, operationContext)

Syntax

Visual Basic
<DefaultOverloadAttribute> _
Public Function StartCopyFromBlobAsync ( _
	source As Uri, _
	sourceAccessCondition As AccessCondition, _
	destAccessCondition As AccessCondition, _
	options As BlobRequestOptions, _
	operationContext As OperationContext _
) As IAsyncOperation(Of String)
C#
[DefaultOverloadAttribute] 
public IAsyncOperation<string> StartCopyFromBlobAsync (
	Uri source,
	AccessCondition sourceAccessCondition,
	AccessCondition destAccessCondition,
	BlobRequestOptions options,
	OperationContext operationContext
)
C++
[DefaultOverloadAttribute] 
public:
IAsyncOperation<String^>^ StartCopyFromBlobAsync (
	Uri^ source, 
	AccessCondition^ sourceAccessCondition, 
	AccessCondition^ destAccessCondition, 
	BlobRequestOptions^ options, 
	OperationContext^ operationContext
)
J#
/** @attribute DefaultOverloadAttribute() */ 
public IAsyncOperation<String> StartCopyFromBlobAsync (
	Uri source, 
	AccessCondition sourceAccessCondition, 
	AccessCondition destAccessCondition, 
	BlobRequestOptions options, 
	OperationContext operationContext
)
JScript
DefaultOverloadAttribute 
public function StartCopyFromBlobAsync (
	source : Uri, 
	sourceAccessCondition : AccessCondition, 
	destAccessCondition : AccessCondition, 
	options : BlobRequestOptions, 
	operationContext : OperationContext
) : IAsyncOperation<String>

Parameters

source

The URI of a source blob.

sourceAccessCondition

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

destAccessCondition

An 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.

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, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012

Target Platforms

See Also