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.
Provides a high level utility for managing transfers to and from Amazon S3.
When uploading large files by specifying file paths instead of a stream,
Namespace: Amazon.S3.Transfer
Assembly: AWSSDK.dll
Version: (assembly version)
public class TransferUtility : Object IDisposable
The TransferUtility type exposes the following members
Name | Description | |
---|---|---|
TransferUtility() | Constructs a new TransferUtility class. | |
TransferUtility(RegionEndpoint) | Constructs a new TransferUtility class. | |
TransferUtility(TransferUtilityConfig) | Constructs a new TransferUtility class. | |
TransferUtility(string, string) | Constructs a new TransferUtility class. | |
TransferUtility(string, string, RegionEndpoint) | Constructs a new TransferUtility class. | |
TransferUtility(string, string, TransferUtilityConfig) | Constructs a new instance of the TransferUtility class. | |
TransferUtility(string, string, RegionEndpoint, TransferUtilityConfig) | Constructs a new instance of the TransferUtility class. | |
TransferUtility(IAmazonS3) | Constructs a new instance of the TransferUtility class. | |
TransferUtility(IAmazonS3, TransferUtilityConfig) | Initializes a new instance of the TransferUtility class. |
Name | Type | Description | |
---|---|---|---|
S3Client | Amazon.S3.IAmazonS3 | Gets the Amazon S3 client used for making calls into Amazon S3. |
Name | Description | |
---|---|---|
AbortMultipartUploads(string, DateTime) | Aborts the multipart uploads that were initiated before the specified date. | |
BeginAbortMultipartUploads(string, DateTime, AsyncCallback, object) | Initiates the asynchronous execution of the AbortMultipartUploads operation. Amazon.S3.Transfer.TransferUtility.AbortMultipartUploads | |
BeginDownload(string, string, string, AsyncCallback, object) | Initiates the asynchronous execution of the Download operation. Amazon.S3.Transfer.TransferUtility.Download | |
BeginDownload(TransferUtilityDownloadRequest, AsyncCallback, object) | Initiates the asynchronous execution of the Download operation. Amazon.S3.Transfer.TransferUtility.Download | |
BeginDownloadDirectory(string, string, string, AsyncCallback, object) | Initiates the asynchronous execution of the DownloadDirectory operation. Amazon.S3.Transfer.TransferUtility.DownloadDirectory | |
BeginDownloadDirectory(TransferUtilityDownloadDirectoryRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DownloadDirectory operation. Amazon.S3.Transfer.TransferUtility.DownloadDirectory | |
BeginOpenStream(string, string, AsyncCallback, object) | Initiates the asynchronous execution of the OpenStream operation. Amazon.S3.Transfer.TransferUtility.Upload | |
BeginOpenStream(TransferUtilityOpenStreamRequest, AsyncCallback, object) | Initiates the asynchronous execution of the OpenStream operation. Amazon.S3.Transfer.TransferUtility.Upload | |
BeginUpload(string, string, AsyncCallback, object) | Initiates the asynchronous execution of the Upload operation. Amazon.S3.Transfer.TransferUtility.Upload | |
BeginUpload(string, string, string, AsyncCallback, object) | Initiates the asynchronous execution of the Upload operation. Amazon.S3.Transfer.TransferUtility.Upload | |
BeginUpload(Stream, string, string, AsyncCallback, object) | Initiates the asynchronous execution of the Upload operation. Amazon.S3.Transfer.TransferUtility.Upload | |
BeginUpload(TransferUtilityUploadRequest, AsyncCallback, object) | Initiates the asynchronous execution of the Upload operation. Amazon.S3.Transfer.TransferUtility.Upload | |
BeginUploadDirectory(string, string, AsyncCallback, object) | Initiates the asynchronous execution of the UploadDirectory operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory | |
BeginUploadDirectory(string, string, string, SearchOption, AsyncCallback, object) | Initiates the asynchronous execution of the UploadDirectory operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory | |
BeginUploadDirectory(TransferUtilityUploadDirectoryRequest, AsyncCallback, object) | Initiates the asynchronous execution of the UploadDirectory operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory | |
Dispose() | Disposes of all managed and unmanaged resources. | |
Download(string, string, string) | Downloads the content from Amazon S3 and writes it to the specified file. | |
Download(TransferUtilityDownloadRequest) | Downloads the content from Amazon S3 and writes it to the specified file. If the key is not specified in the request parameter, the file name will used as the key name. | |
DownloadDirectory(string, string, string) |
Downloads the objects in Amazon S3 that have a key that starts with the value
specified by |
|
DownloadDirectory(TransferUtilityDownloadDirectoryRequest) |
Downloads the objects in Amazon S3 that have a key that starts with the value
specified by the |
|
EndAbortMultipartUploads(IAsyncResult) | Finishes the asynchronous execution of the AbortMultipartUploads operation. Amazon.S3.Transfer.TransferUtility.AbortMultipartUploads | |
EndDownload(IAsyncResult) | Finishes the asynchronous execution of the Download operation. Amazon.S3.Transfer.TransferUtility.Download | |
EndDownloadDirectory(IAsyncResult) | Finishes the asynchronous execution of the DownloadDirectory operation. Amazon.S3.Transfer.TransferUtility.Download | |
EndOpenStream(IAsyncResult) | Finishes the asynchronous execution of the OpenStream operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory | |
EndUpload(IAsyncResult) | Finishes the asynchronous execution of the Upload operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory | |
EndUploadDirectory(IAsyncResult) | Finishes the asynchronous execution of the UploadDirectory operation. Amazon.S3.Transfer.TransferUtility.UploadDirectory | |
OpenStream(string, string) | Returns a stream from which the caller can read the content from the specified Amazon S3 bucket and key. The caller of this method is responsible for closing the stream. | |
OpenStream(TransferUtilityOpenStreamRequest) |
Returns a stream to read the contents from Amazon S3 as
specified by the |
|
Upload(string, string) | Uploads the specified file. The object key is derived from the file's name. Multiple threads are used to read the file and perform multiple uploads in parallel. For large uploads, the file will be divided and uploaded in parts using Amazon S3's multipart API. The parts will be reassembled as one object in Amazon S3. | |
Upload(string, string, string) | Uploads the specified file. Multiple threads are used to read the file and perform multiple uploads in parallel. For large uploads, the file will be divided and uploaded in parts using Amazon S3's multipart API. The parts will be reassembled as one object in Amazon S3. | |
Upload(Stream, string, string) | Uploads the contents of the specified stream. For large uploads, the file will be divided and uploaded in parts using Amazon S3's multipart API. The parts will be reassembled as one object in Amazon S3. | |
Upload(TransferUtilityUploadRequest) |
Uploads the file or stream specified by the request.
To track the progress of the upload,
add an event listener to the request's |
|
UploadDirectory(string, string) | Uploads files from a specified directory. The object key is derived from the file names inside the directory. For large uploads, the file will be divided and uploaded in parts using Amazon S3's multipart API. The parts will be reassembled as one object in Amazon S3. | |
UploadDirectory(string, string, string, SearchOption) | Uploads files from a specified directory. The object key is derived from the file names inside the directory. For large uploads, the file will be divided and uploaded in parts using Amazon S3's multipart API. The parts will be reassembled as one object in Amazon S3. | |
UploadDirectory(TransferUtilityUploadDirectoryRequest) | Uploads files from a specified directory. The object key is derived from the file names inside the directory. For large uploads, the file will be divided and uploaded in parts using Amazon S3's multipart API. The parts will be reassembled as one object in Amazon S3. |
Transfers are stored in memory. If the application is restarted, previous transfers are no longer accessible. In this situation, if necessary, you should clean up any multipart uploads that are incomplete.
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8.1, Windows 8
.NET for Windows Phone:
Supported in: Windows Phone 8.1, Windows Phone 8