.NET-SDK之如何实现上传文件（一）?

在OSS中，用户操作的基本数据单元是文件（Object）。单个文件最大允许大小根据上传数据方式不同而不同，Put Object方式最大不能超过5GB, 使用multipart上传方式文件大小不能超过48.8TB。

简单的上传



上传指定字符串：

1. using System.Text;
2. using Aliyun.OSS;
4. // 初始化OssClient
5. var client = new OssClient(endpoint, accessKeyId, accessKeySecret)
6. try
7. {
8.     string str = "a line of simple text";
9.     byte[] binaryData = Encoding.ASCII.GetBytes(str);            
10.     MemoryStream requestContent = new MemoryStream(binaryData);
11.     client.PutObject(bucketName, key, requestContent);
12.     Console.WriteLine("Put object succeeded");
13. }
14. catch (Exception ex)
15. {
16.     Console.WriteLine("Put object failed, {0}", ex.Message);
17. }

说明： 完整代码参考： GitHub。

1. using Aliyun.OSS;
3. // 初始化OssClient
4. var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
5. try
6. {
7.     string fileToUpload = "your local file path";
8.     client.PutObject(bucketName, key, fileToUpload);
9.     Console.WriteLine("Put object succeeded");
10. }
11. catch (Exception ex)
12. {
13.     Console.WriteLine("Put object failed, {0}", ex.Message);
14. }

说明： 完整代码参考 GitHub。

1. using Aliyun.OSS;
2. using Aliyun.OSS.util;
4. // 初始化OssClient
5. var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
6. try
7. {
8.     string fileToUpload = "your local file path";
9.     string md5;
10.     using (var fs = File.Open(fileToUpload, FileMode.Open));
11.     {
12.         md5 = OssUtils.ComputeContentMd5(fs, fs.Length);
13.     }  
15.     var objectMeta = new ObjectMetadata
16.     {
17.         ContentMd5 = md5
18.     };
19.     client.PutObject(bucketName, key, fileToUpload, objectMeta);
20.     Console.WriteLine("Put object succeeded");
21. }
22. catch (Exception ex)
23. {
24.     Console.WriteLine("Put object failed, {0}", ex.Message);
25. }

说明：

• 完整代码参考GitHub。
• 为了保证SDK发送的数据和OSS服务端接收到的数据一致，可以在ObjectMeta中增加Content-Md5值，这样服务端就会使用这个MD5值做校验。
• 使用Md5时，性能会有所损失。

1. using Aliyun.OSS;
3. // 初始化OssClient
4. var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
6. try
7. {
8.     using (var fs = File.Open(fileToUpload, FileMode.Open))
9.     {
10.         var metadata = new ObjectMetadata();                    
11.         metadata.ContentLength = fs.Length;
12.         metadata.ExpirationTime = DateTime.Parse("2015-10-12T00:00:00.000Z");      
13.         client.PutObject(bucketName, key, fs, metadata);    
14.         Console.WriteLine("Put object succeeded");
15.     }
16. }
17. catch (Exception ex)
18. {
19.     Console.WriteLine("Put object failed, {0}", ex.Message);
20. }

说明：

• 完整代码参考GitHub。
• .NET SDK支持的Http Header：Cache-Control 、 Content-Disposition 、Content-Encoding 、 Expires、Content-Type等 。
• 它们的相关介绍见 RFC2616 。

1. using Aliyun.OSS;
3. // 初始化OssClient
4. var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
6. try
7. {
8.     using (var fs = File.Open(fileToUpload, FileMode.Open))
9.     {
10.         var metadata = new ObjectMetadata();
11.         metadata.UserMetadata.Add("name", "my-data");
12.         metadata.ContentLength = fs.Length;
13.         client.PutObject(bucketName, key, fs, metadata);  
14.         Console.WriteLine("Put object succeeded");
15.     }
16. }
17. catch (Exception ex)
18. {
19.     Console.WriteLine("Put object failed, {0}", ex.Message);
20. }

说明：

• 完整代码参考GitHub。
• 在上面代码中，用户自定义了一个名字为“name”，值为“my-data”的元信息。
• 当用户下载此文件的时候，此元信息也可以一并得到。
• 一个文件可以有多个类似的参数，但所有的user meta总大小不能超过2KB。
• 使用上述方法上传最大文件不能超过5G。如果超过可以使用MutipartUpload上传。
• user meta的名称大小写不敏感，比如用户上传文件时，定义名字为“Name”的meta,在表头中存储的参数为：“x-oss-meta-name”,所以读取时读取名字为“name”的参数即可。
• 但如果存入参数为“name”，读取时使用“Name”读取不到对应信息，会返回“null”。