ASP.NET实战教程：结合ASPX与TextBox控件，轻松实现向钉钉自定义机器人推送文本消息(附详细源代码)

Tomato_19569

已于 2024-05-20 16:59:30 修改

阅读量573

点赞数 9

分类专栏： ASPX .NET开发钉钉文章标签： asp.net 钉钉机器人

于 2024-05-20 16:58:16 首次发布

本文链接：https://blog.csdn.net/weixin_43915164/article/details/139068520

版权

ASPX 同时被 3 个专栏收录

3 篇文章 0 订阅

订阅专栏

.NET开发

3 篇文章 0 订阅

订阅专栏

钉钉

1 篇文章 0 订阅

订阅专栏

在数字化办公日益普及的今天，自动化消息推送成为了提升工作效率的重要手段之一。本文将手把手教你如何在ASP.NET Web应用中，利用ASPX页面和TextBox控件，实现向钉钉自定义机器人发送文本消息的功能，让信息流转更加便捷高效。

准备工作

创建钉钉自定义机器人：首先，你需要在钉钉群聊中创建一个自定义机器人，获取到机器人的Webhook地址，这是后续推送消息的关键。
开发环境：确保你的开发环境已配置好Visual Studio，以及.NET Framework（或.NET Core，取决于你的项目需求）。

步骤一：创建ASPX页面

打开Visual Studio，新建一个ASP.NET Web应用程序项目。
在项目中添加一个新的ASPX页面，例如命名为DingTalkRobot.aspx。
在该页面中，拖拽一个TextBox控件用于输入要发送的文本消息，以及一个Button控件用于触发发送操作。

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="DingTalkRobot.aspx.cs" Inherits="test.DingTalkRobot" %>

<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:TextBox ID="TextBox4" runat="server"></asp:TextBox>
            <asp:Button ID="DingTalk" runat="server" Text="向钉钉发送信息" OnClick="DingTalk_Click" />
        </div>
    </form>
</body>
</html>

步骤二：编写后台代码

在SendToDingTalk.aspx.cs的后台代码文件中，编写按钮点击事件的处理逻辑，定义一个ConvertToUnicode来辅助将字符串转换为Unicode格式。sign的值使用HmacSHA256算法计算，得到的sign使用UTF-8字符集再进行urlEncode，得到最终的签名。WebClient发送POST请求到钉钉自定义机器人的webhook URL，并拼接timestamp和sign参数进行请求。

using System;
using System.Net;
using System.Security.Cryptography;
using System.Text;
using System.Web;
namespace test
{
    public partial class DingTalkRobot : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {

        }
        protected void DingTalk_Click(object sender, EventArgs e)
        {
            string webhookUrl = "您钉钉机器人的webhookUrl值";
            string secret = "您钉钉机器人的secret值";
            string timestamp = GetTimestamp();//获取当前时间戳（13位）
            string sign = GenerateSign(timestamp, secret);//使用GenerateSign根据时间戳和SECRET生成签名，包括HmacSHA256算法计算签名、Base64编码以及URL编码
            string tb4 = TextBox4.Text;

            // 转换为Unicode编码表示的字符串
            string unicodeString4 = ConvertToUnicode(tb4);

            // 为了安全起见，对Unicode字符串进行Html编码.确保任何特殊字符都被转换成HTML实体，从而防止潜在的XSS攻击
            unicodeString = HttpUtility.HtmlEncode(unicodeString4);


            try
            {
                string postData = "{\"msgtype\":\"text\",\"text\":{\"content\":\"" + unicodeString + "\"}}";

                using (WebClient client = new WebClient())//WebClient发送POST请求到钉钉自定义机器人的webhook URL，并附带timestamp和sign参数。
                {
                    client.Headers.Add("Content-Type", "application/json; charset=utf-8");
                    //调用webhookUrl发送消息时，需要拼接timestamp和sign参数
                    string response = client.UploadString(webhookUrl + "&timestamp=" + timestamp + "&sign=" + sign, postData);
                    Response.Write("消息发送结果: " + response);
                    Response.Write("发送前转换的值: " + unicodeString);
                    Response.Write("发送的postData的值: " + postData);
                }
            }
            catch (Exception ex)
            {
                Response.Write("发送失败: " + ex.Message);
            }

        }
        private string GetTimestamp()
        {
            TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
            return Convert.ToInt64(ts.TotalMilliseconds).ToString();
        }

        private string GenerateSign(string timestamp, string secret)
        {
            string stringToSign = timestamp + "\n" + secret;
            byte[] keyByte = Encoding.UTF8.GetBytes(secret);
            byte[] messageBytes = Encoding.UTF8.GetBytes(stringToSign);

            //sign的值使用HmacSHA256算法计算签名
            using (HMACSHA256 hmac = new HMACSHA256(keyByte))
            {
                byte[] hashBytes = hmac.ComputeHash(messageBytes);
                //进行Base64 encode
                string sign = Convert.ToBase64String(hashBytes);
                //把签名参数再进行urlEncode，得到最终的签名。使用UTF-8字符集
                return HttpUtility.UrlEncode(sign);
            }
        }
        // 辅助方法，将字符串转换为Unicode格式
        private string ConvertToUnicode(string input)
        {
            var unicodeBuilder = new StringBuilder();
            foreach (char c in input)
            {
                // 对于每个字符，添加一个\u后跟字符的十六进制表示
                unicodeBuilder.Append("\\u" + ((int)c).ToString("x4"));
            }
            return unicodeBuilder.ToString();
        }
    }
}

注意事项

安全考量：在实际部署时，需确保Webhook URL的安全性，避免泄露。
异常处理：在上述示例中，为了简化展示，直接使用了.Result来等待异步操作完成。在生产环境中，推荐使用async/await模式来处理异步操作，并做好异常捕获。
消息格式：根据钉钉机器人的接口文档，可以调整消息体内容，发送更丰富的消息类型，如Markdown、Link、ActionCard等。

通过以上步骤，你就可以在ASP.NET Web应用中，通过简单的TextBox输入和按钮点击，实现实时向钉钉自定义机器人推送文本消息的功能。希望这篇教程能帮助你快速上手钉钉机器人推送服务。

※ 文中有说错的解释，欢迎评论区纠正

※ 代码只需替换webhookUrl和secret即可点击按钮推送

※ 声明：本文为原创如转载请标注本文地址