BeginUpload Method (request, callback, state)

Initiates the asynchronous execution of the Upload operation.

Declaration Syntax

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

Parameters

request (TransferUtilityUploadRequest): Contains all the parameters required to upload to Amazon S3.

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

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