BeginUploadDirectory Method (directory, bucketName, searchPattern, searchOption, callback, state)

Initiates the asynchronous execution of the UploadDirectory operation.

Declaration Syntax

public IAsyncResult BeginUploadDirectory(
	string directory,
	string bucketName,
	string searchPattern,
	SearchOption searchOption,
	AsyncCallback callback,
	Object state
)

Parameters

directory (String): The source directory, that is, the directory containing the files to upload.

bucketName (String): The target Amazon S3 bucket, that is, the name of the bucket to upload the files to.

searchPattern (String): A pattern used to identify the files from the source directory to upload.

searchOption (SearchOption): A search option that specifies whether to recursively search for files to upload in subdirectories.

callback (AsyncCallback): An AsyncCallback delegate that is invoked when the operation completes.

state (Object): A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the AsyncState property.

Return Value

An IAsyncResult that can be used to poll, or wait for results, or both. This value is also needed when invoking EndUploadDirectory.

Remarks

If you are uploading large files, TransferUtility will use multipart upload to fulfill the request. If a multipart upload is interrupted, TransferUtility will attempt to abort the multipart upload. Under certain circumstances (network outage, power failure, etc.), TransferUtility will not be able to abort the multipart upload. In this case, in order to stop getting charged for the storage of uploaded parts, you should manually invoke TransferUtility.AbortMultipartUploads() to abort the incomplete multipart uploads.

Exceptions

Exception	Condition
ArgumentNullException
WebException
AmazonS3Exception