.NET SDK
下载地址
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:
mkdir demo
进入demo文件夹,生成一个console工程:
cd demo
dotnet new console
生成的目录结构:
demo
|--demo.csproj
|--Program.cs
|-- obj/
将下面的依赖加入工程下面的 *.csproj 文件中的 <Project>
元素中。
<ItemGroup>
<PackageReference Include="aliyun-net-sdk-core" Version="1.1.12"/>
<PackageReference Include="aliyun-net-sdk-imm" Version="1.0.0"/>
</ItemGroup>
注意:请关注 github 提供的最新版本,查看相关功能并选择使用。
然后编辑 Program.cs
:
using System;
using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.imm.Model.V20170906;
using System.Collections.Generic;
namespace net_test
{
class Program
{
static void Main(string[] args)
{
// 构建一个 Client,用于发起请求
IClientProfile profile = DefaultProfile.GetProfile(
"cn-shanghai", //配置 region
"your_access_key_id", //配置 accessKeyId
"your_access_key_secret"); //配置 accessKeySecert
DefaultAcsClient client = new DefaultAcsClient(profile);
try
{
// 构造请求
ListProjectsRequest request = new ListProjectsRequest();
// 发起请求,并得到 Response
ListProjectsResponse response = client.GetAcsResponse(request);
List<Aliyun.Acs.imm.Model.V20170906.ListProjectsResponse.ListProjects_ProjectsItem> projects = response.Projects;
foreach(Aliyun.Acs.imm.Model.V20170906.ListProjectsResponse.ListProjects_ProjectsItem project in projects){
Console.WriteLine(project.Project);
}
}
catch (ServerException ex)
{
System.Console.WriteLine(ex.ToString());
}
catch (ClientException ex)
{
System.Console.WriteLine(ex.ToString());
}
}
}
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论