Aliyun OSS SDK for C#
GitHub version
Build Status
關(guān)于
- 此C# SDK基于阿里云對象存儲服務(wù) API構(gòu)建。
- 阿里云對象存儲（Object Storage Service婆咸，簡稱OSS）谈截，是阿里云對外提供的海量筷屡，安全，低成本簸喂，高可靠的云存儲服務(wù)毙死。
- OSS適合存放任意文件類型，適合各種網(wǎng)站喻鳄、開發(fā)企業(yè)及開發(fā)者使用扼倘。
- 使用此SDK，用戶可以方便地在任何應(yīng)用除呵、任何時間再菊、任何地點上傳，下載和管理數(shù)據(jù)颜曾。
版本
- 當(dāng)前版本：2.3.0
運行環(huán)境
Windows
- 適用于
.NET 2.0及以上版本 - 適用于
Visual Studio 2010及以上版本
Linux/Mac
- 適用于
Mono 3.12及以上版本
安裝方法
Windows環(huán)境安裝
NuGet安裝
- 如果您的Visual Studio沒有安裝NuGet纠拔，請先安裝 NuGet.
- 安裝好NuGet后，先在
Visual Studio中新建或者打開已有的項目泛豪，然后選擇<工具>－<NuGet程序包管理器>－<管理解決方案的NuGet程序包>稠诲， - 搜索
aliyun.oss.sdk，在結(jié)果中找到Aliyun.OSS.SDK诡曙，選擇最新版本臀叙，點擊安裝，成功后添加到項目應(yīng)用中价卤。
GitHub安裝
- 如果沒有安裝git劝萤，請先安裝 git
- git clone https://github.com/aliyun/aliyun-oss-csharp-sdk.git
- 下載好源碼后，按照
項目引入方式安裝即可
DLL引用方式安裝
- 從阿里云OSS官網(wǎng)下載SDK包慎璧，解壓后bin目錄包括了Aliyun.OSS.dll文件床嫌。
- 在Visual Studio的
<解決方案資源管理器>中選擇您的項目，然后右鍵<項目名稱>-<引用>胸私，在彈出的菜單中選擇<添加引用>既鞠，
在彈出<添加引用>對話框后，選擇<瀏覽>盖文，找到SDK包解壓的目錄嘱蛋，在bin目錄下選中<Aliyun.OSS.dll>文件,點擊確定即可
項目引入方式安裝
- 如果是下載了SDK包或者從GitHub上下載了源碼，希望源碼安裝，可以右鍵
<解決方案>洒敏，在彈出的菜單中點擊<添加>-><現(xiàn)有項目>龄恋。 - 在彈出的對話框中選擇
aliyun-oss-sdk.csproj文件，點擊打開凶伙。 - 接下來右鍵
<您的項目>－<引用>郭毕，選擇<添加引用>，在彈出的對話框選擇<項目>選項卡后選中aliyun-oss-sdk項目函荣，點擊確定即可显押。
Unix/Mac環(huán)境安裝
NuGet安裝
- 先在
Xamarin中新建或者打開已有的項目，然后選擇<工具>－<Add NuGet Packages>傻挂。 - 搜索
aliyun.oss.sdk乘碑，在結(jié)果中找到Aliyun.OSS.SDK，選擇最新版本金拒，點擊<Add Package>兽肤，成功后添加到項目應(yīng)用中。
GitHub安裝
- 如果沒有安裝git绪抛，請先安裝 git
- git clone https://github.com/aliyun/aliyun-oss-csharp-sdk.git
- 下載好源碼后资铡，使用Xamarin打開，在Release模式下編譯aliyun-oss-sdk項目幢码，生成Aliyun.OSS.dll笤休，然后通過DLL引用方式安裝
DLL引用方式安裝
- 從阿里云OSS官網(wǎng)下載SDK包，解壓后bin目錄包括了Aliyun.OSS.dll文件症副。
- 在Xamarin的
<解決方案>中選擇您的項目宛官，然后右鍵<項目名稱>-<引用>，在彈出的菜單中選擇<Edit References>瓦糕，
在彈出<Edit References>對話框后，選擇<.Net Assembly>-<瀏覽>腋么，找到SDK包解壓的目錄咕娄，在bin目錄下選中<Aliyun.OSS.dll>文件,點擊<Open>即可
快速使用
獲取存儲空間列表（List Bucket）
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
var buckets = client.ListBuckets();
foreach (var bucket in buckets)
{
Console.WriteLine(bucket.Name + ", " + bucket.Location + ", " + bucket.Owner);
}
創(chuàng)建存儲空間（Create Bucket）
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
client.CreateBucket(bucketName);
刪除存儲空間（Delete Bucket）
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
client.DeleteBucket(bucketName);
上傳文件（Put Object）
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
client.PutObject(bucketName, key, filePathToUpload);
下載文件 (Get Object)
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
var object = ossClient.GetObject(bucketName, key);
獲取文件列表（List Objects）
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
var listResult = client.ListObjects(bucketName);
foreach (var summary in listResult.ObjectSummaries)
{
Console.WriteLine(summary.Key);
}
刪除文件(Delete Object)
OssClient client = new OssClient(endpoint, accessKeyId, accessKeySecret);
client.DeleteObject(bucketName, key)
其他
上面的例子中，如果沒有拋出異常則說明執(zhí)行成功珊擂，否則失敗圣勒，更詳細的例子可以在aliyun-oss-sample項目中查看并運行。
注意事項
- 如果要運行sample摧扇，需要將aliyun-oss-sdk-sample項目設(shè)為
啟動項目圣贸，并添加您自己的AccessKeyId，AccessKeySecret扛稽，bucket吁峻，key等后即可運行。
聯(lián)系我們
- 阿里云OSS官方網(wǎng)站
- 阿里云OSS官方論壇
- 阿里云OSS官方文檔中心
- 阿里云官方技術(shù)支持：提交工單
