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 Upload operation. Amazon.S3.Transfer.TransferUtility.Upload

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

Syntax

C# 
public IAsyncResult BeginUpload(
         TransferUtilityUploadRequest request,
         AsyncCallback callback,
         Object state
)

Parameters

request
Type: Amazon.S3.Transfer.TransferUtilityUploadRequest

Contains all the parameters required to upload to Amazon S3.

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 values is also needed when invoking EndUpload.

Exceptions

ExceptionCondition
System.ArgumentNullException
System.Net.WebException
AmazonS3Exception

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