CloudFile.StartCopyAsync Method (CloudFile, AccessCondition, AccessCondition, FileRequestOptions, OperationContext, CancellationToken) (Microsoft.WindowsAzure.Storage.File)
From Microsoft Windows Azure Storage Blob
Initiates an asynchronous operation to start copying another file's contents, properties, and metadata to this file.
Namespace:
Microsoft.WindowsAzure.Storage.File
Assembly:
Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute]
public virtual Task<string> StartCopyAsync(
CloudFile source,
AccessCondition sourceAccessCondition,
AccessCondition destAccessCondition,
FileRequestOptions options,
OperationContext operationContext,
CancellationToken cancellationToken
)
C++
public:
[DoesServiceRequestAttribute]
virtual Task<String^>^ StartCopyAsync(
CloudFile^ source,
AccessCondition^ sourceAccessCondition,
AccessCondition^ destAccessCondition,
FileRequestOptions^ options,
OperationContext^ operationContext,
CancellationToken cancellationToken
)
[<DoesServiceRequestAttribute>]
abstract StartCopyAsync :
source:CloudFile *
sourceAccessCondition:AccessCondition *
destAccessCondition:AccessCondition *
options:FileRequestOptions *
operationContext:OperationContext *
cancellationToken:CancellationToken -> Task<string>
[<DoesServiceRequestAttribute>]
override StartCopyAsync :
source:CloudFile *
sourceAccessCondition:AccessCondition *
destAccessCondition:AccessCondition *
options:FileRequestOptions *
operationContext:OperationContext *
cancellationToken:CancellationToken -> Task<string>
<DoesServiceRequestAttribute>
Public Overridable Function StartCopyAsync (
source As CloudFile,
sourceAccessCondition As AccessCondition,
destAccessCondition As AccessCondition,
options As FileRequestOptions,
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 file. If null, no condition is used.
- options
-
Type:
Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File::FileRequestOptions^Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File.FileRequestOptions
A FileRequestOptions 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 another file's contents, properties, and metadata to this file.
Syntax
[DoesServiceRequestAttribute] public virtual Task<string> StartCopyAsync( CloudFile source, AccessCondition sourceAccessCondition, AccessCondition destAccessCondition, FileRequestOptions options, OperationContext operationContext, CancellationToken cancellationToken )
public: [DoesServiceRequestAttribute] virtual Task<String^>^ StartCopyAsync( CloudFile^ source, AccessCondition^ sourceAccessCondition, AccessCondition^ destAccessCondition, FileRequestOptions^ options, OperationContext^ operationContext, CancellationToken cancellationToken )
[<DoesServiceRequestAttribute>] abstract StartCopyAsync : source:CloudFile * sourceAccessCondition:AccessCondition * destAccessCondition:AccessCondition * options:FileRequestOptions * operationContext:OperationContext * cancellationToken:CancellationToken -> Task<string> [<DoesServiceRequestAttribute>] override StartCopyAsync : source:CloudFile * sourceAccessCondition:AccessCondition * destAccessCondition:AccessCondition * options:FileRequestOptions * operationContext:OperationContext * cancellationToken:CancellationToken -> Task<string>
<DoesServiceRequestAttribute> Public Overridable Function StartCopyAsync ( source As CloudFile, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As FileRequestOptions, 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 file. If null, no condition is used.
- options
-
Type:
Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File::FileRequestOptions^Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File.FileRequestOptions
A FileRequestOptions 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.