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(
         String filePath,
         String bucketName,
         AsyncCallback callback,
         Object state
)

Parameters

filePath
Type: System.String

The file path of the file to upload.

bucketName
Type: System.String

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

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