DataTransferOptions Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
DataTransferOptions is used to provide options for a transfer.
public class DataTransferOptions : IEquatable<Azure.Storage.DataMovement.DataTransferOptions>
type DataTransferOptions = class
interface IEquatable<DataTransferOptions>
Public Class DataTransferOptions
Implements IEquatable(Of DataTransferOptions)
- Inheritance
-
DataTransferOptions
- Implements
Constructors
DataTransferOptions() |
Properties
CreationPreference |
Configures the behavior when a transfer encounters a resource that already exists. Will default to Default which will be FailIfExists when starting a new transfer. When resuming a transfer, the value will default to the value used when first starting the transfer for all resources that were successfully enumerated and the regular default for any remaining resources. |
InitialTransferSize |
The size of the first range request in bytes. Single Transfer sizes smaller than this limit will be Uploaded or Downloaded in a single request. Transfers larger than this limit will continue being downloaded or uploaded in chunks of size MaximumTransferChunkSize. The default value is 32 MiB. When resuming a transfer, the default value will be the value specified when the transfer was first started. This value may be clamped to the maximum allowed for the particular transfer/resource type. |
MaximumTransferChunkSize |
The maximum size to use for each chunk when transferring data in chunks. The default value is 4 MiB. When resuming a transfer, the default value will be the value specified when the transfer was first started. This value may be clamped to the maximum allowed for the particular transfer/resource type. |
ProgressHandlerOptions |
Optional. Options for changing behavior of the ProgressHandler. |
Events
ItemTransferCompleted |
If a single transfer within the resource container gets transferred successfully the event will get added to this handler. Only applies to container transfers, not single resource transfers. |
ItemTransferFailed |
If the transfer has any failed events that occur the event will get added to this handler. |
ItemTransferSkipped |
If the transfer has any skipped events that occur the event will get added to this handler. Skipped transfer occur during Transfer due to no overwrite allowed as specified in CreationPreference |
TransferStatusChanged |
If the transfer status of the job changes then the event will get added to this handler. |
Applies to
Azure SDK for .NET