作者：王先榮
? ?本文介紹微信公眾號中的範(fàn)本訊息，包含以下內(nèi)容：（1）TemplateMessage類別簡介；（2）設(shè)定所屬產(chǎn)業(yè)；（3）取得範(fàn)本id； （4）發(fā)送範(fàn)本訊息；（5）接收推播範(fàn)本訊息發(fā)送結(jié)果事件。

1 TemplateMessage類別簡介
? ? TemplateMessage靜態(tài)類別封裝了與範(fàn)本訊息相關(guān)的方法，請參閱下表：

2 設(shè)定所屬產(chǎn)業(yè)

? ? TemplateMessage類別的SetIndustry方法用於設(shè)定公眾號所屬的產(chǎn)業(yè)，此方法的定義如下：

        /// <summary>
        /// 設(shè)置行業(yè)        /// </summary>
        /// <param name="userName">公眾號</param>
        /// <param name="code1">行業(yè)代碼1</param>
        /// <param name="code2">行業(yè)代碼2</param>
        /// <returns>返回設(shè)置是否成功</returns>
        public static ErrorMessage SetIndustry(string userName, string code1, string code2)        //或者

        /// <summary>
        /// 設(shè)置行業(yè)        /// </summary>
        /// <param name="userName">公眾號</param>
        /// <param name="industry1">行業(yè)1</param>
        /// <param name="industry2">行業(yè)2</param>
        /// <returns>返回設(shè)置是否成功</returns>
        public static ErrorMessage SetIndustry(string userName, Industry industry1, Industry industry2)

? ? 其中，Industry為行業(yè)類，類中的靜態(tài)成員包含了已知的所有行業(yè)，例如：Industry.OnlineGame代表了網(wǎng)絡(luò)遊戲這一行業(yè)；Industry類有三個屬性，分別為：Code－產(chǎn)業(yè)代碼，Name－產(chǎn)業(yè)名稱，PrimaryIndustry－主產(chǎn)業(yè)。

? ? 設(shè)定所屬產(chǎn)業(yè)的範(fàn)例：

/// <summary>
    /// 設(shè)置所屬行業(yè)
    /// </summary>
    /// <param name="sender"></param>
    /// <param name="e"></param>
    protected void btnSetIndustry_Click(object sender, EventArgs e)
    {
        string userName = lbPublicAccount.SelectedValue;
        string industryCode1 = "", industryCode2 = "";
        int count = 0;
        foreach (ListItem item in cblIndustry.Items)
        {
            if (item.Selected)
            {
                count++;
                if (count == 1)
                    industryCode1 = item.Value;
                else if (count == 2)
                {
                    industryCode2 = item.Value;
                    break;
                }
            }
        }
        if (count != 2)
            ltrMessage.Text = "請選擇兩個行業(yè)。";
        else
        {
            ErrorMessage errorMessage = TemplateMessage.SetIndustry(userName, industryCode1, industryCode2);
            ltrMessage.Text = string.Format("設(shè)置所屬行業(yè){0}。{1}",
                errorMessage.IsSuccess ? "成功" : "失敗",
                errorMessage.IsSuccess ? "" : errorMessage.ToString());
        }
    }

設(shè)置所屬行業(yè)示例

設(shè)定所屬產(chǎn)業(yè)範(fàn)例

3 取得範(fàn)本id

? ? TemplateMessage類別的GetId方法用於取得模板id，此方法定義如下：

        /// <summary>
        /// 獲取模板ID        /// </summary>
        /// <param name="userName">公眾號</param>
        /// <param name="shortTemplateId">模板庫中模板的編號，有“TM**”和“OPENTMTM**”等形式</param>
        /// <param name="errorMessage">返回獲取是否成功</param>
        /// <returns>返回模板ID；如果獲取失敗，返回空字符串。</returns>
        public static string GetId(string userName, string shortTemplateId, out ErrorMessage errorMessage)

? ? 注意：（1）如果尚未新增模板，則該方法會先新增模板，然後返回模板id；（2）如果已經(jīng)新增了模板，再次呼叫該方法，會傳回一個新的不同於上次取得的模板id。

? ? 取得模板id的範(fàn)例：

    /// <summary>
    /// 添加并模板id    /// </summary>
    /// <param name="sender"></param>
    /// <param name="e"></param>
    protected void btnGetTemplateId_Click(object sender, EventArgs e)
    {        string userName = lbPublicAccount.SelectedValue;
        ErrorMessage errorMessage;        string templateId = TemplateMessage.GetId(userName, txtTemplateIdShort.Text, out errorMessage);        if (errorMessage.IsSuccess)
            ltrMessage.Text = string.Format("添加并獲取模板id成功。模板id：{0}", templateId);        else
            ltrMessage.Text = string.Format("添加并獲取模板id失敗。{0}", errorMessage.ToString());
    }

#取得範(fàn)本id範(fàn)例

?

4 傳送模板訊息
? ? TemplateMessage類別的Send方法用於傳送範(fàn)本訊息，方法定義如下：

        /// <summary>
        /// 發(fā)送模板消息        /// </summary>
        /// <param name="userName">公眾號</param>
        /// <param name="touser">接收消息的賬號</param>
        /// <param name="templateId">模板id</param>
        /// <param name="detailUrl">詳情地址</param>
        /// <param name="topColor">頂端顏色</param>
        /// <param name="data">數(shù)據(jù)</param>
        /// <param name="errorMessage">返回發(fā)送是否成功</param>
        /// <returns>返回消息id；如果發(fā)送失敗，返回-1。</returns>
        public static long Send(string userName, string touser, string templateId, string detailUrl, Color topColor,
            Tuple<string, string, Color>[] data, out ErrorMessage errorMessage)

? ? 其中，data參數(shù)為Tuple類型，包含模板所使用的數(shù)據(jù)，data.Item1為數(shù)據(jù)鍵，data.Item2為數(shù)據(jù)值，data.Item3為顯示數(shù)據(jù)的顏色。

? ? 傳送範(fàn)本訊息的範(fàn)例：

/// <summary>
        /// 發(fā)送模板消息
        /// </summary>
        /// <param name="userName">公眾號</param>
        /// <param name="touser">接收消息的賬號</param>
        /// <param name="templateId">模板id</param>
        /// <param name="detailUrl">詳情地址</param>
        /// <param name="topColor">頂端顏色</param>
        /// <param name="data">數(shù)據(jù)</param>
        /// <param name="errorMessage">返回發(fā)送是否成功</param>
        /// <returns>返回消息id；如果發(fā)送失敗，返回-1。</returns>
        public static long Send(string userName, string touser, string templateId, string detailUrl, Color topColor,
            Tuple<string, string, Color>[] data, out ErrorMessage errorMessage)

#傳送範(fàn)本訊息範(fàn)例

5 接收推播範(fàn)本訊息傳送結(jié)果事件
? ? 在傳送範(fàn)本訊息之後，微信伺服器會推送結(jié)果到公眾號碼的指定URL上，公眾號碼伺服器會接收到一封RequestTemplateSendJobFinishMessage類型的請求訊息。
? ? RequestTemplateSendJobFinishMessage類別有以下唯讀屬性：

/// <summary>
        /// 獲取消息id
        /// </summary>
        public long MsgID { get; private set; }
        /// <summary>
        /// 獲取群發(fā)消息的結(jié)果
        /// </summary>
        public string Status { get; private set; }

        /// <summary>
        /// 獲取消息是否群發(fā)成功
        /// </summary>
        public TemplateMessageSendStatusEnum SendStatus
        {
            get
            {
                TemplateMessageSendStatusEnum status;
                if (Status == sendFailedUserBlock)
                    status = TemplateMessageSendStatusEnum.UserBlock;
                else if (Status == sendFailedSystemFailed)
                    status = TemplateMessageSendStatusEnum.SystemFailed;
                else
                    status = TemplateMessageSendStatusEnum.Success;
                return status;
            }
        }

以上是.net微信公眾號開發(fā)的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！