文档

Csharp SDK手册(澳洲和新加坡区域)

更新时间:
一键部署
重要

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

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

创建AccessKey

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

  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安装方式

安装 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());
                }
            }
        }
    }
  • 本页导读 (0)
文档反馈