文档

CSharp SDK 手册(华东1(杭州))

更新时间:
一键部署
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

本文介绍了如何安装和使用C# SDK。

创建AccessKey

(注:也可以使用阿里云访问控制服务创建的Access Key。)

  1. 登录 AccessKey管理控制台

  2. 单击页面右上角创建 AccessKey按钮,弹出创建对话框。

  3. 阅读《API使用规范》后,单击同意并创建

(推荐)安装 C# SDK

开发环境

阿里云邮件推送的 C# SDK 支持 .Net Framework 2.0 或以上版本。

SDK 安装

通过dotnet进行安装

1、添加依赖包

您可以在openAPI页面,“SDK信息”获取新版本号。

dotnet add package AlibabaCloud.SDK.Dm20151123 --version 1.0.x
重要

version 1.0.x为示例,实际添加中请填写在openAPI中获取的最新版本号。

2、跳转到openAPI进行调试,选择开发语言,填写参数,下载自动生成的代码(会包含参数值)。

调试页面无须填写Key值。

警告

请勿在代码中硬编码"accessKeyId","accessKeySecret"值,以免泄露。

阿里云SDK支持在操作系统的环境变量中定义ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET的值,代码中从环境变量获取后进行鉴权,参考文档:身份验证配置

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

image.png

(不推荐)旧版SDK安装方式

SDK下载

直接下载:https://aliyundm.oss-cn-hangzhou.aliyuncs.com/example/aliyun-net-sdk-dmV3.1.0.zip

SDK 安装

1、在解压的文件中可以找到 aliyun-net-sdk-core.dll 和 aliyun-net-sdk-dm.dll 这两个文件。

2、在您的Visual Studio上右键点击项目,再单击添加引用>浏览(如果您用的是MonoDevelop,请按照导入 DLL 的相应方法导入这个 .dll 文件),选择以上 .dll 文件,单击确定按钮。

您就可以在工程中使用阿里云邮件推送 C# SDK 了。

发送邮件示例

调用单一发信 API 示例 (如何调用此接口,请参见 SingleSendMail )。如果需要了解样例代码中GetProfile和DefaultAcsClient细节,可以查看源码

    using System;
		using Aliyun.Acs.Core;
    using Aliyun.Acs.Core.Exceptions;
    using Aliyun.Acs.Core.Profile;
    using Aliyun.Acs.Dm.Model.V20151123;

    namespace ConsoleApp
    {
        class Program
        {
            static void Main(string[] args)
            {
                //Create a client used for initiating a request
              	//请在环境变量中配置ALIBABA_CLOUD_ACCESS_KEY_ID,ALIBABA_CLOUD_ACCESS_KEY_SECRET。
                //参考文档:https://help.aliyun.com/document_detail/2361895.html 
                IClientProfile profile = DefaultProfile.GetProfile("cn-hangzhou", Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
                IAcsClient client = new DefaultAcsClient(profile);
                SingleSendMailRequest request = new SingleSendMailRequest();
                try {
                    //Version must set to "2017-06-22" when the regionId is not "cn-hangzhou"
                    //request.Version = "2017-06-22";
                    request.AccountName = "控制台创建的发信地址";
                    request.FromAlias = "发信人昵称";
                    request.AddressType = 1;
                    request.TagName = "控制台创建的标签";
                    request.ReplyToAddress = true;
                    request.ToAddress = "目标地址";
                    request.Subject = "邮件主题" ;
                    request.HtmlBody = "邮件正文" ;
                    SingleSendMailResponse httpResponse = client.GetAcsResponse(request);
                } catch (ServerException e) {
                    System.Console.WriteLine(e.ToString());
                }
                catch (ClientException e) {
                    System.Console.WriteLine(e.ToString());
                }
            }
        }
    }
  • 本页导读 (0)
文档反馈