澳洲和新加坡区域如何安装和使用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安装方式

安装 C# SDK

开发环境

阿里云C# SDK的.NET 开发环境：

    .NET Framework 4.6.1 或以上
    .NET Standard 2.0 或以上

SDK 安装

必须为您使用的任何SDK安装SDK核心Nuget包.

使用包管理器

    Install-Package aliyun-net-sdk-core
    Install-Package aliyun-net-sdk-dm-overseas -Version 4.7.2

您还可以使用VisualStudio来安装.NET Framework应用程序，参考https://docs.microsoft.com/en-us/nuget/quickstart/install-and-use-a-package-in-visual-studio 在包浏览器中搜索我们的SDK名称“aliyun net SDK dm overseas”。

发送邮件示例

调用单一发信 API 示例（如何调用此接口，请参见 SingleSendMail）：

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

    namespace ConsoleApp
    {
        class Program
        {
            static void Main(string[] args)
            {      
                //Region-Id: ap-southeast-1 for Singapore Region and ap-southeast-2 for Australlia Region
                string regionId = "ap-southeast-1";

                //Region-Host: dm.ap-southeast-1.aliyuncs.com for Singapore Region and dm.ap-southeast-2.aliyuncs.com for Australlia Region
                string regionHost = "dm.ap-southeast-1.aliyuncs.com";
              
				//请在环境变量中配置ALIBABA_CLOUD_ACCESS_KEY_ID，ALIBABA_CLOUD_ACCESS_KEY_SECRET。
                //参考文档：https://help.aliyun.com/document_detail/2361895.html   
                IClientProfile profile = DefaultProfile.GetProfile(regionId, Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
                IAcsClient client = new DefaultAcsClient(profile);


                DefaultProfile.AddEndpoint(regionHost, regionId, "Dm", regionHost);
                SingleSendMailRequest request = new SingleSendMailRequest();
                try {
                    request.AccountName = "Sender address created in the console";
                    request.FromAlias = "Sender nickname";
                    request.AddressType = 1;
                    request.TagName = "Tag created in the console";
                    request.ReplyToAddress = true;
                    request.ToAddress = "Destination address";
                    request.Subject = "Subject";
                    request.HtmlBody = "Body";
                    SingleSendMailResponse httpResponse = client.GetAcsResponse(request);
                    System.Console.WriteLine(httpResponse.RequestId);
                } catch (ServerException e) {
                    System.Console.WriteLine(e.ToString());
                }
                catch (ClientException e) {
                    System.Console.WriteLine(e.ToString());
                }
            }
        }
    }