Skip to content

jefth/aliyun-oss-csharp-sdk

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aliyun OSS SDK for C#

Build Status Software License

关于

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

版本

  • 当前版本:2.2.0

运行环境

Windows

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

Linux/Mac

  • 适用于Mono 3.12 及以上版本

安装方法

Windows环境安装

NuGet安装

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

GitHub安装

DLL引用方式安装

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

项目引入方式安装

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

Unix/Mac环境安装

NuGet安装

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

GitHub安装

DLL引用方式安装

  • 从阿里云OSS官网下载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);
    }

创建存储空间(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等后即可运行。

联系我们

About

Aliyun OSS SDK for C#

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%