AWS SDK Version 2 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

.NET Framework 3.5
 
Initiates the asynchronous execution of the UploadDirectory operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory

Namespace: Amazon.S3.Transfer
Assembly: AWSSDK.dll
Version: (assembly version)

Syntax

C#
public IAsyncResult BeginUploadDirectory(
         String directory,
         String bucketName,
         String searchPattern,
         SearchOption searchOption,
         AsyncCallback callback,
         Object state
)

Parameters

directory
Type: System.String

The source directory, that is, the directory containing the files to upload.

bucketName
Type: System.String

The target Amazon S3 bucket, that is, the name of the bucket to upload the files to.

searchPattern
Type: System.String

A pattern used to identify the files from the source directory to upload.

searchOption
Type: System.IO.SearchOption

A search option that specifies whether to recursively search for files to upload in subdirectories.

callback
Type: System.AsyncCallback

An AsyncCallback delegate that is invoked when the operation completes.

state
Type: System.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
Type: System.IAsyncResult
An IAsyncResult that can be used to poll, or wait for results, or both. This value is also needed when invoking EndUploadDirectory.

Exceptions

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.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5