CloudBlockBlob.StartCopyAsync Method (CloudFile, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) (Microsoft.WindowsAzure.Storage.Blob)
From Microsoft Windows Azure Storage Blob
Initiates an asynchronous operation to start copying a file's contents, properties, and metadata to this block blob.
Namespace:
Microsoft.WindowsAzure.Storage.Blob
Assembly:
Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute]
public virtual Task<string> StartCopyAsync(
CloudFile source,
AccessCondition sourceAccessCondition,
AccessCondition destAccessCondition,
BlobRequestOptions options,
OperationContext operationContext,
CancellationToken cancellationToken
)
C++
public:
[DoesServiceRequestAttribute]
virtual Task<String^>^ StartCopyAsync(
CloudFile^ source,
AccessCondition^ sourceAccessCondition,
AccessCondition^ destAccessCondition,
BlobRequestOptions^ options,
OperationContext^ operationContext,
CancellationToken cancellationToken
)
[<DoesServiceRequestAttribute>]
abstract StartCopyAsync :
source:CloudFile *
sourceAccessCondition:AccessCondition *
destAccessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
cancellationToken:CancellationToken -> Task<string>
[<DoesServiceRequestAttribute>]
override StartCopyAsync :
source:CloudFile *
sourceAccessCondition:AccessCondition *
destAccessCondition:AccessCondition *
options:BlobRequestOptions *
operationContext:OperationContext *
cancellationToken:CancellationToken -> Task<string>
<DoesServiceRequestAttribute>
Public Overridable Function StartCopyAsync (
source As CloudFile,
sourceAccessCondition As AccessCondition,
destAccessCondition As AccessCondition,
options As BlobRequestOptions,
operationContext As OperationContext,
cancellationToken As CancellationToken
) As Task(Of String)
Parameters
- source
-
Type:
Microsoft.WindowsAzure.Storage.File.CloudFileMicrosoft.WindowsAzure.Storage.File::CloudFile^Microsoft.WindowsAzure.Storage.File.CloudFileMicrosoft.WindowsAzure.Storage.File.CloudFile
A CloudFile object.
- sourceAccessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the access conditions for the source file. If null, no condition is used.
- destAccessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the access conditions for the destination blob. 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.
- cancellationToken
-
Type:
System.Threading.CancellationTokenSystem.Threading::CancellationTokenSystem.Threading.CancellationTokenSystem.Threading.CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Return Value
Type:
System.Threading.Tasks.Task<String>System.Threading.Tasks::Task<String^>^System.Threading.Tasks.Task<String>System.Threading.Tasks.Task(Of String)A Task<TResult><TResult><'TResult>(Of TResult) object of type string that represents the asynchronous operation.
Return to top
Initiates an asynchronous operation to start copying a file's contents, properties, and metadata to this block blob.
Syntax
[DoesServiceRequestAttribute] public virtual Task<string> StartCopyAsync( CloudFile source, AccessCondition sourceAccessCondition, AccessCondition destAccessCondition, BlobRequestOptions options, OperationContext operationContext, CancellationToken cancellationToken )
public: [DoesServiceRequestAttribute] virtual Task<String^>^ StartCopyAsync( CloudFile^ source, AccessCondition^ sourceAccessCondition, AccessCondition^ destAccessCondition, BlobRequestOptions^ options, OperationContext^ operationContext, CancellationToken cancellationToken )
[<DoesServiceRequestAttribute>] abstract StartCopyAsync : source:CloudFile * sourceAccessCondition:AccessCondition * destAccessCondition:AccessCondition * options:BlobRequestOptions * operationContext:OperationContext * cancellationToken:CancellationToken -> Task<string> [<DoesServiceRequestAttribute>] override StartCopyAsync : source:CloudFile * sourceAccessCondition:AccessCondition * destAccessCondition:AccessCondition * options:BlobRequestOptions * operationContext:OperationContext * cancellationToken:CancellationToken -> Task<string>
<DoesServiceRequestAttribute> Public Overridable Function StartCopyAsync ( source As CloudFile, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken ) As Task(Of String)
Parameters
- source
-
Type:
Microsoft.WindowsAzure.Storage.File.CloudFileMicrosoft.WindowsAzure.Storage.File::CloudFile^Microsoft.WindowsAzure.Storage.File.CloudFileMicrosoft.WindowsAzure.Storage.File.CloudFile
A CloudFile object.
- sourceAccessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the access conditions for the source file. If null, no condition is used.
- destAccessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the access conditions for the destination blob. 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.
- cancellationToken
-
Type:
System.Threading.CancellationTokenSystem.Threading::CancellationTokenSystem.Threading.CancellationTokenSystem.Threading.CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Return Value
Type: System.Threading.Tasks.Task<String>System.Threading.Tasks::Task<String^>^System.Threading.Tasks.Task<String>System.Threading.Tasks.Task(Of String)A Task<TResult><TResult><'TResult>(Of TResult) object of type string that represents the asynchronous operation.