全部产品
云市场

.NET SDK

更新时间:2018-11-13 23:25:08

下载地址

IMM Service 的 C# SDK 让 C# 开发人员可以非常方便地使用 C# 程序操作服务。开发者可以直接使用 NuGet 依赖添加 SDK。目前,SDK 适用于 .NET Framework 4.0 及以上版本, 已经开源到 github

操作步骤

为快速开始使用 IMM Service C# SDK,请按照如下步骤进行。

步骤 1 创建阿里云账号

具体方法请参考 阿里云账号注册流程

为了更好地使用阿里云服务,建议尽快完成实名认证,否则部分阿里云服务将无法使用。具体实名认证流程,请参考 这里

步骤 2 获取阿里云访问密钥

为了使用 IMM Service C# SDK,您必须申请阿里云的 访问密钥。

登录阿里云 密钥管理页面。选择一对用于 SDK 的访问密钥对。如果没有,请创建一对新访问密钥,且保证它处于启用状态。有关如何创建访问密钥,参见 创建访问密钥

该密钥对会在下面的步骤使用,且需要保管好,不能对外泄露。另外,您可以参考 SDK 配置了解更多 SDK 如何使用访问密钥的信息。

步骤 3 创建项目

在使用 IMM 服务 C# SDK 之前,请先在控制台上创建好项目(Project)。有关如何创建 Project ,参见 创建项目

步骤 4 安装 .NET 开发环境

目前,IMM C# SDK 支持 .NET Framework 4.0 及以上版本,您可以从 .NET 官方网站 下载并按说明安装 .NET 开发环境。

步骤 5 开始一个新的 C# 项目

创建一个文件夹 demo:

  1. mkdir demo

进入demo文件夹,生成一个console工程:

  1. cd demo
  2. dotnet new console

生成的目录结构:

  1. demo
  2. |--demo.csproj
  3. |--Program.cs
  4. |-- obj/

将下面的依赖加入工程下面的 *.csproj 文件中的 <Project> 元素中。

  1. <ItemGroup>
  2. <PackageReference Include="aliyun-net-sdk-core" Version="1.1.12"/>
  3. <PackageReference Include="aliyun-net-sdk-imm" Version="1.0.0"/>
  4. </ItemGroup>

注意:请关注 github 提供的最新版本,查看相关功能并选择使用。

然后编辑 Program.cs

  1. using System;
  2. using Aliyun.Acs.Core;
  3. using Aliyun.Acs.Core.Profile;
  4. using Aliyun.Acs.Core.Exceptions;
  5. using Aliyun.Acs.imm.Model.V20170906;
  6. using System.Collections.Generic;
  7. namespace net_test
  8. {
  9. class Program
  10. {
  11. static void Main(string[] args)
  12. {
  13. // 构建一个 Client,用于发起请求
  14. IClientProfile profile = DefaultProfile.GetProfile(
  15. "cn-shanghai", //配置 region
  16. "your_access_key_id", //配置 accessKeyId
  17. "your_access_key_secret"); //配置 accessKeySecert
  18. DefaultAcsClient client = new DefaultAcsClient(profile);
  19. try
  20. {
  21. // 构造请求
  22. ListProjectsRequest request = new ListProjectsRequest();
  23. // 发起请求,并得到 Response
  24. ListProjectsResponse response = client.GetAcsResponse(request);
  25. List<Aliyun.Acs.imm.Model.V20170906.ListProjectsResponse.ListProjects_ProjectsItem> projects = response.Projects;
  26. foreach(Aliyun.Acs.imm.Model.V20170906.ListProjectsResponse.ListProjects_ProjectsItem project in projects){
  27. Console.WriteLine(project.Project);
  28. }
  29. }
  30. catch (ServerException ex)
  31. {
  32. System.Console.WriteLine(ex.ToString());
  33. }
  34. catch (ClientException ex)
  35. {
  36. System.Console.WriteLine(ex.ToString());
  37. }
  38. }
  39. }
  40. }

若在使用中有疑问,请参考 FAQ,或者进入 钉钉用户群 实时交流。