如何安装和使用C#SDK_邮件推送-阿里云帮助中心

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

创建Access Key

（注：也可以使用阿里云访问控制服务创建的 Access Key。）

登录 Access Key 管理控制台。
单击页面右上角按钮 创建 Access Key，弹出创建对话框。
阅读《API使用规范》后，单击 同意并创建。

（推荐）安装 C# SDK

开发环境

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

SDK 安装

通过 dotnet 进行安装

1.添加依赖包

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

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

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

调试页面无须填写Key值。

警告

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

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

调试

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

（不推荐）旧版SDK安装方式

SDK下载

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

SDK 安装

在解压的文件中可以找到 aliyun-net-sdk-core.dll 和 aliyun-net-sdk-dm.dll 这两个文件。
在您的 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());
                }
            }
        }
    }