/// <summary>
/// Uploads the file or stream specified by the request.
/// To track the progress of the upload,
/// add an event listener to the request's <c>UploadProgressEvent</c>.
/// 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.
/// </summary>
/// <param name="request">
/// Contains all the parameters used for uploading to Amazon S3.
/// </param>
public void Upload(TransferUtilityUploadRequest request)
{
validate(request);
BaseCommand command;
if (request.ContentLength < this._config.MinSizeBeforePartUpload)
{
command = new SimpleUploadCommand(this._s3Client, this._config, request);
}
else
{
command = new MultipartUploadCommand(this._s3Client, this._config, request);
}
command.Execute();
}
/// <summary>
/// Uploads the file or stream specified by the request.
/// To track the progress of the upload,
/// add an event listener to the request's <c>UploadProgressEvent</c>.
/// 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.
/// </summary>
/// <param name="request">
/// Contains all the parameters used for uploading to Amazon S3.
/// </param>
public void Upload(TransferUtilityUploadRequest request)
{
if (request == null)
{
throw new ArgumentNullException("request");
}
if (!request.IsSetBucketName())
{
throw new ArgumentNullException("bucketName");
}
if (!request.IsSetFilePath() &&
!request.IsSetInputStream())
{
throw new ArgumentException(
"Please specify either a Filename or provide a Stream to PUT an object into S3.");
}
if (!request.IsSetKey())
{
if (request.IsSetFilePath())
{
request.Key = new FileInfo(request.FilePath).Name;
}
else
{
throw new ArgumentException(
"The Key property must be specified when using a Stream to upload into S3.");
}
}
if (request.IsSetFilePath() && !File.Exists(request.FilePath))
throw new ArgumentException("The file indicated by the FilePath property does not exist!");
if (request.ContentLength < this._config.MinSizeBeforePartUpload)
{
SimpleUploadCommand uploader = new SimpleUploadCommand(this._s3Client, this._config, request);
uploader.Execute();
}
else
{
MultipartUploadCommand uploader = new MultipartUploadCommand(this._s3Client, this._config, request);
uploader.Execute();
}
}
/// <summary>
/// Initiates the asynchronous execution of the Upload operation.
/// <seealso cref="M:Amazon.S3.Transfer.TransferUtility.Upload"/>
/// </summary>
/// <param name="request">
/// Contains all the parameters used for uploading to Amazon S3.
/// </param>
/// <param name="callback">An AsyncCallback delegate that is invoked when the operation completes.</param>
/// <param name="state">A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the AsyncState property.</param>
/// <exception cref="T:System.ArgumentNullException"></exception>
/// <exception cref="T:System.Net.WebException"></exception>
/// <exception cref="T:Amazon.S3.AmazonS3Exception"></exception>
/// <returns>An IAsyncResult that can be used to poll or wait for results, or both;
/// this value is also needed when invoking EndUpload.</returns>
public IAsyncResult BeginUpload(TransferUtilityUploadRequest request, AsyncCallback callback, object state)
{
validate(request);
BaseCommand command;
if (request.ContentLength < this._config.MinSizeBeforePartUpload)
{
command = new SimpleUploadCommand(this._s3Client, this._config, request);
}
else
{
command = new MultipartUploadCommand(this._s3Client, this._config, request);
}
return beginOperation(command, callback, state);
}
internal BaseCommand GetUploadCommand(TransferUtilityUploadRequest request, SemaphoreSlim asyncThrottler)
{
validate(request);
if (IsMultipartUpload(request))
{
var command = new MultipartUploadCommand(this._s3Client, this._config, request);
command.AsyncThrottler = asyncThrottler;
return command;
}
else
{
var command = new SimpleUploadCommand(this._s3Client, this._config, request);
command.AsyncThrottler = asyncThrottler;
return command;
}
}