无标题文章

Aliyun OSS SDK for C#

Software License

GitHub version

Build Status

关于

• 此C# SDK基于阿里云对象存储服务 API构建。
• 阿里云对象存储（Object Storage Service，简称OSS），是阿里云对外提供的海量，安全，低成本，高可靠的云存储服务。
• OSS适合存放任意文件类型，适合各种网站、开发企业及开发者使用。
• 使用此SDK，用户可以方便地在任何应用、任何时间、任何地点上传，下载和管理数据。

版本

• 当前版本：2.3.0

运行环境

Windows

• 适用于.NET 2.0 及以上版本
• 适用于Visual Studio 2010及以上版本

Linux/Mac

• 适用于Mono 3.12 及以上版本

安装方法

Windows环境安装

NuGet安装

• 如果您的Visual Studio没有安装NuGet，请先安装 NuGet.
• 安装好NuGet后，先在Visual Studio中新建或者打开已有的项目，然后选择<工具>－－<管理解决方案的NuGet程序包>，
• 搜索aliyun.oss.sdk，在结果中找到Aliyun.OSS.SDK，选择最新版本，点击安装，成功后添加到项目应用中。

GitHub安装

• 如果没有安装git，请先安装 git
• git clone https://github.com/aliyun/aliyun-oss-csharp-sdk.git
• 下载好源码后，按照项目引入方式安装即可

DLL引用方式安装

• 从阿里云OSS官网下载SDK包，解压后bin目录包括了Aliyun.OSS.dll文件。
• 在Visual Studio的<解决方案资源管理器>中选择您的项目，然后右键<项目名称>-<引用>，在弹出的菜单中选择<添加引用>，
  在弹出<添加引用>对话框后，选择<浏览>，找到SDK包解压的目录，在bin目录下选中文件,点击确定即可

项目引入方式安装

• 如果是下载了SDK包或者从GitHub上下载了源码，希望源码安装，可以右键<解决方案>，在弹出的菜单中点击<添加>-><现有项目>。
• 在弹出的对话框中选择aliyun-oss-sdk.csproj文件，点击打开。
• 接下来右键<您的项目>－<引用>，选择<添加引用>，在弹出的对话框选择<项目>选项卡后选中aliyun-oss-sdk项目，点击确定即可。

Unix/Mac环境安装

NuGet安装

• 先在Xamarin中新建或者打开已有的项目，然后选择<工具>－。
• 搜索aliyun.oss.sdk，在结果中找到Aliyun.OSS.SDK，选择最新版本，点击，成功后添加到项目应用中。

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官网下载SDK包，解压后bin目录包括了Aliyun.OSS.dll文件。
• 在Xamarin的<解决方案>中选择您的项目，然后右键<项目名称>-<引用>，在弹出的菜单中选择，
  在弹出对话框后，选择<.Net Assembly>-<浏览>，找到SDK包解压的目录，在bin目录下选中文件,点击即可

快速使用

获取存储空间列表（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);
    }

创建存储空间（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)

其他

上面的例子中，如果没有抛出异常则说明执行成功，否则失败，更详细的例子可以在aliyun-oss-sample项目中查看并运行。

注意事项

• 如果要运行sample，需要将aliyun-oss-sdk-sample项目设为启动项目，并添加您自己的AccessKeyId，AccessKeySecret，bucket，key等后即可运行。

联系我们

• 阿里云OSS官方网站
• 阿里云OSS官方论坛
• 阿里云OSS官方文档中心
• 阿里云官方技术支持：提交工单