Delen via


DataTransferOptions Class

Definition

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