简单上传是指通过PutObject方法上传单个文件(Object)。简单上传包括上传字符串和上传本地文件,您可以使用同步方式或者异步方式进行上传。您也可以使用MD5校验来确保上传过程中的数据完整性。
上传字符串
说明 上传字符串的完整代码请参见
GitHub。
以下代码用于将字符串上传到目标存储空间examplebucket中的exampleobject.txt文件。
using System.Text; using Aliyun.OSS; // yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。 var endpoint = "yourEndpoint"; // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。 var accessKeyId = "yourAccessKeyId"; var accessKeySecret = "yourAccessKeySecret"; // 填写Bucket名称。 var bucketName = "examplebucket"; // 填写Object完整路径。Object完整路径中不能包含Bucket名称。 var objectName = "exampleobject.txt"; // 填写字符串。 var objectContent = "More than just cloud."; // 创建OssClient实例。 var client = new OssClient(endpoint, accessKeyId, accessKeySecret); try { byte[] binaryData = Encoding.ASCII.GetBytes(objectContent); MemoryStream requestContent = new MemoryStream(binaryData); // 上传文件。 client.PutObject(bucketName, objectName, requestContent); Console.WriteLine("Put object succeeded"); } catch (Exception ex) { Console.WriteLine("Put object failed, {0}", ex.Message); }
上传本地文件
说明 上传本地文件的完整代码请参见
GitHub。
以下代码用于将本地文件examplefile.txt上传到目标存储空间examplebucket中的exampleobject.txt文件。
using Aliyun.OSS; // yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。 var endpoint = "yourEndpoint"; // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。 var accessKeyId = "yourAccessKeyId"; var accessKeySecret = "yourAccessKeySecret"; // 填写Bucket名称。 var bucketName = "examplebucket"; // 填写Object完整路径。Object完整路径中不能包含Bucket名称。 var objectName = "exampleobject.txt"; // 填写本地文件的完整路径。如果未指定本地路径,则默认从示例程序所属项目对应本地路径中上传文件。 var localFilename = "D:\\localpath\\examplefile.txt"; // 创建OssClient实例。 var client = new OssClient(endpoint, accessKeyId, accessKeySecret); try { // 上传文件。 client.PutObject(bucketName, objectName, localFilename); Console.WriteLine("Put object succeeded"); } catch (Exception ex) { Console.WriteLine("Put object failed, {0}", ex.Message); }
上传文件并且带MD5校验
说明 上传文件并且带MD5校验的完整代码请参见
GitHub。
为保证客户端发送的数据和OSS服务端接收到的数据一致,您可以在ObjectMeta中增加Content-Md5值,OSS服务端会使用该MD5值做校验。
注意 使用MD5校验时,性能会有所下降。
以下代码用于上传本地文件时进行MD5校验。
using Aliyun.OSS; using Aliyun.OSS.Util; // yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。 var endpoint = "yourEndpoint"; // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。 var accessKeyId = "yourAccessKeyId"; var accessKeySecret = "yourAccessKeySecret"; // 填写Bucket名称。 var bucketName = "examplebucket"; // 填写Object完整路径。Object完整路径中不能包含Bucket名称。 var objectName = "exampleobject.txt"; // 填写本地文件的完整路径。如果未指定本地路径,则默认从示例程序所属项目对应本地路径中上传文件。 var localFilename = "D:\\localpath\\examplefile.txt"; // 创建OssClient实例。 var client = new OssClient(endpoint, accessKeyId, accessKeySecret); try { // 计算MD5。 string md5; using (var fs = File.Open(localFilename, FileMode.Open)) { md5 = OssUtils.ComputeContentMd5(fs, fs.Length); } var objectMeta = new ObjectMetadata { ContentMd5 = md5 }; // 上传文件。 client.PutObject(bucketName, objectName, localFilename, objectMeta); Console.WriteLine("Put object succeeded"); } catch (Exception ex) { Console.WriteLine("Put object failed, {0}", ex.Message); }
异步上传
说明 异步上传文件的完整代码请参见
GitHub。
以下代码用于以异步方式将本地文件examplefile.txt上传到目标存储空间examplebucket中的exampleobject.txt文件。使用异步上传时,您需要实现自己的回调处理函数。
using System; using System.IO; using System.Threading; using Aliyun.OSS; using Aliyun.OSS.Common; // 异步上传。 namespace AsyncPutObject { class Program { // yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。 static string endpoint = "yourEndpoint"; // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。 static string accessKeyId = "yourAccessKeyId"; static string accessKeySecret = "yourAccessKeySecret"; // 填写Bucket名称。 static string bucketName = "examplebucket"; // 填写Object完整路径。Object完整路径中不能包含Bucket名称。 static string objectName = "exampleobject.txt"; // 填写本地文件的完整路径。如果未指定本地路径,则默认从示例程序所属项目对应本地路径中上传文件。 static string localFilename = "D:\\localpath\\examplefile.txt"; static AutoResetEvent _event = new AutoResetEvent(false); // 创建OssClient实例。 static OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret); private static void PutObjectCallback(IAsyncResult ar) { try { client.EndPutObject(ar); Console.WriteLine(ar.AsyncState as string); Console.WriteLine("Put object succeeded"); } catch (Exception ex) { Console.WriteLine(ex.Message); } finally { _event.Set(); } } public static void AsyncPutObject() { try { using (var fs = File.Open(localFilename, FileMode.Open)) { var metadata = new ObjectMetadata(); // 增加自定义元信息。 metadata.UserMetadata.Add("mykey1", "myval1"); metadata.UserMetadata.Add("mykey2", "myval2"); metadata.CacheControl = "No-Cache"; metadata.ContentType = "text/txt"; string result = "Notice user: put object finish"; // 异步上传。 client.BeginPutObject(bucketName, objectName, fs, metadata, PutObjectCallback, result.ToCharArray()); _event.WaitOne(); } } catch (OssException ex) { Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}", ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId); } catch (Exception ex) { Console.WriteLine("Failed with error info: {0}", ex.Message); } } static void Main(string[] args) { Program.AsyncPutObject(); } } }