C#开发微信公众平台

C#开发微信公众平台-就这么简单服务号和订阅号URL配置创建菜单查询、删除菜单接受消息发送消息（图文、菜单事件响应）示例Demo下载后记最近公司在做微信开发，其实就是接口开发，网上找了很多资料，当然园友也写了很多教程，但都是理论说了一大堆，实用指导或代码很少。如果你自己仔细研究下，其实就那么点东西，C#实现起来也很简单，原本不想写这篇文章的，但是本人当时摸索走了很多弯路，这边总结下，希望初次接触微信公众平台的朋友别像当时的我一样。自己动手，丰衣足食。服务号和订阅号服务号是公司申请的微信公共账号，订阅号是个人申请的，我个人也申请了一个，不过没怎么用。服务号1个月（30天）内仅可以发送1条群发消息。发给订阅用户（粉丝）的消息，会显示在对方的聊天列表中。在发送消息给用户时，用户将收到即时的消息提醒。服务号会在订阅用户（粉丝）的通讯录中。可申请自定义菜单。订阅号每天（24小时内）可以发送1条群发消息。发给订阅用户（粉丝）的消息，将会显示在对方的订阅号文件夹中。在发送消息给订阅用户（粉丝）时，订阅用户不会收到即时消息提醒。在订阅用户（粉丝）的通讯录中，订阅号将被放入订阅号文件夹中。订阅号不支持申请自定义菜单。URL配置启用开发模式需要先成为开发者，而且编辑模式和开发模式只能选择一个，进入微信公众平台-开发模式，如下：启用开发模式需要先成为开发者，而且编辑模式和开发模式只能选择一个，进入微信公众平台-开发模式，如下：需要填写url和token，当时本人填写这个的时候花了好久，我本以为填写个服务器的url就可以了（80端口），但是不行，主要是没有仔细的阅读提示信息，所以总是提示第二步：验证URL有效性开发者提交信息启「微信』瞬器椿发送GET请求到填写的URL上「GET请求携带四个参数描述signature微伺签名rsignature结合了开发者填写的请求中的timestamp#数、nonce#^,time-stamp时间戳nonce亡匚hostr随机字符串开发者通过检验寸请求进行校验［下面有校验方式）*若确认此次GFT请求来自微涪服务器”®原样返回Mhost「碁内容则接入生效r成丸开发者成功f吾则接入失败"从上面可以看出，点击提交后微信会向我们填写的服务器发送几个参数，然后需要原样返回出来，所以在提交url的时候，先在服务器创建接口测试返回echostr参数内容。代码：viewsourceprint?01.1 //成为开发者url测试，返回echoStr02.2 publicvoidInterfaceTest（）03.3 {04.4 stringtoken="填写的token";05.5 if（string.IsNullOrEmpty（token））return;06.6 {return;07.708.8}09.9stringechoString=Context.Current.Request.QueryString["echoStr"];stringsignature=Context.Current.Request.QueryString["signature"];stringtimestamp=Context.Current.Request.QueryString["timestamp"];stringnonce=Context.Current.Request.QueryString["nonce"];14.14if(!string.IsNullOrEmpty(echoString)){Context.Current.Response.Write(echoString);Context.Current.Response.End();}}在一般处理程序ashx的ProcessRequest的方法内调用上面的方法，url填写的就是这个ashx的服务器地址，token是一个服务器标示，可以随便输入，代码中的token要和申请填写的一致，成为开发者才能做开发。创建菜单我们添加一些微信服务号，聊天窗口下面有些菜单，这个可以在编辑模式简单配置，也可以在开发模式代码配置。微信公众平台开发者文档：：〃/wiki/index.php?title=自定义菜单创建接口，可以看到创建菜单的一些要点，下面的使用网页调试工具调试该接口，只是调试接口是否可用，并不是直接创建菜单的，菜单分为两种：click：用户点击click类型按钮后，微信服务器会通过消息接口推送消息类型为event的结构给开发者(参考消息接口指南)，并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值与用户进行交互。view：用户点击view类型按钮后，微信客户端将会打开开发者在按钮中填写的url值(即网页链接)，达到打开网页的目的，建议与网页授权获取用户基本信息接口结合，获得用户的登入个人信息。click菜单需要填一个key，这个是在我们菜单点击事件的时候会用到，view只是一个菜单超链接。菜单数据是json格式，官网是php示例，其实C#实现起来也很简单，就是post发送一个json数据，示例代码：01.1publicpartialclasscreateMenu：System.Web.UI.Page02.2{03.3 protectedvoidPage_Load(objectsender,EventArgse)04.4 {05.5 FileStreamfs1=newFileStream(Server.MapPath(".")+"\\menu.txt",FileMode.Open);06.6 StreamReader sr = newStreamReader(fs1,Encoding.GetEncoding("GBK"));07.7 stringmenu = sr.ReadToEnd();08.8 sr.Close();09.9 fs1.Close();GetPage("s：//api.weixin.<;a class="keylink" href="：//./qq/"target="_blank">qq</a>.com/cgi-bin/menu/create?access_token=access_token",menu);}publicstringGetPage(stringposturl, stringpostData){Streamoutstream=null;Streaminstream=null;StreamReadersr=null;WebResponseresponse=null;WebRequestrequest=null;Encodingencoding=Encoding.UTF8;byte[]data=encoding.GetBytes(postData);//准备请求...try{//设置参数request=WebRequest.Create(posturl)asWebRequest;CookieContainercookieContainer=newCookieContainer();request.CookieContainer=cookieContainer;request.AllowAutoRedirect=true;request.Method="POST";request.ContentType="application/x--form-urlencoded";request.ContentLength=data.Length;outstream=request.GetRequestStream();outstream.Write(data,0,data.Length);outstream.Close();//发送请求并获取相应回应数据response=request.GetResponse()asWebResponse;〃直到request.GetResponse()程序才开始向目标网页发送Post请求instream=response.GetResponseStream();sr=newStreamReader(instream,encoding);〃返回结果网页(html)代码stringcontent=sr.ReadToEnd();stringerr=string.Empty;43.43Response.Write(content);44.44returncontent;45.45}46.46catch(Exceptionex)47.47{48.48stringerr=ex.Message;49.49returnstring.Empty;50.50}51.51}52.52}menu.text里面的内容就是json示例菜单，大家可以从示例复制下来，按照你的需要修改一些就行了。关于access_token，其实就是一个请求标示，获取方式：s:///cgi-bin/token?grant_type=client_credential&appid=appid&secret=secretappid和secret是开发者标示，在你的信息里面可以看到，通过这个链接返回一个json数据，就可以得到access_token值。需要注意的是：access_token有一定的时效性，失效的话就需要重新获取下，这个在本机就可以创建，不需要上传到服务器，创建菜单正确，返回{"errcode":0,"errmsg":"ok"}提示信息。这边就不截图了，大家试下就可以看到效果，一般创建菜单是一到两分钟生效，实在不行就重新关注下。查询、删除菜单查询和删除菜单也很简单，只不过是get请求，不需要传数据，看下示例代码：01.1publicpartialclassselectMenu:System.Web.UI.Page02.2{03.3protectedvoidPage_Load(objectsender,EventArgse)TOC\o"1-5"\h\z04.4 {05.5 GetPage("s:///cgi-bin/menu/get?access_token=access_token");06.6 //GetPage("s:///cgi-bin/menu/delete?access_token=access_token");07.7 }08.8 publicstringGetPage(stringposturl)09.9 {Streaminstream=null;StreamReadersr=null;WebResponseresponse=null;WebRequestrequest=null;Encodingencoding=Encoding.UTF8;//准备请求...try{//设置参数request=WebRequest.Create(posturl)asWebRequest;CookieContainercookieContainer=newCookieContainer();request.CookieContainer=cookieContainer;request.AllowAutoRedirect=true;request.Method="GET";request.ContentType="application/x--form-urlencoded";//发送请求并获取相应回应数据response=request.GetResponse()asWebResponse;〃直到request.GetResponse()程序才开始向目标网页发送Post请求instream=response.GetResponseStream();sr=newStreamReader(instream, encoding);〃返回结果网页(html)代码stringcontent=sr.ReadToEnd();stringerr=string.Empty;Response.Write(content);returncontent;TOC\o"1-5"\h\z}catch(Exceptionex){stringerr=ex.Message;returnstring.Empty;}}}access_token获取方式上面已经讲过了，查询菜单返回的是json数据，其实就是我们创建菜单的menu.txt里面的内容。删除成功返回信息提示：{"errcode":0,"errmsg":"ok"}，这个也只要在本地运行就可以了。接受消息微信公众平台开发者文档：：〃/wiki/index.php?title^收普通消息，我们使用微信就是要对用户发送的信息进行处理，这边以接受普通消息为例，语音、图片消息等，举一反三可得。从文档上可以看出接受消息获得的是一个xml格式文件，当时有点犯傻的是，我要在哪边进行接受消息啊？还郁闷了半天，其实就是你一开始填写的url，是不是很汗颜啊，哈哈。<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[thisisatest]]></Content><MsgId>1234567890123456</MsgId></xml>我们在ashx添加下面代码：01.1 publicvoidProcessRequest(Contextparam_context)TOC\o"1-5"\h\z02.2 {03.3 stringpostString=string.Empty;04.4 if(Context.Current.Request.Method.ToUpper()=="POST")05.5 {06.6 using(Streamstream=Context.Current.Request.InputStream)07.7 {08.8Byte[]postBytes=newByte[stream.Length];09.9stream.Read(postBytes,0,(Int32)stream.Length);postString=Encoding.UTF8.GetString(postBytes);Handle(postString);}}}15.15///<summary>17.17 ///处理信息并应答///</summary>privatevoidHandle(stringpostStr){messageHelphelp=newmessageHelp();stringresponseContent=help.ReturnMessage(postStr);23.23Context.Current.Response.ContentEncoding=Encoding.UTF8;Context.Current.Response.Write(responseContent);}messageHelp是消息处理帮助类，这边提供下部分代码，完整的可以下载来，获取的postString是xml，格式如上，我们这边只需要转换成XmlDocument进行解析就行了：01.1 //接受文本消息02.2 publicstringTextHandle(XmlDocumentxmldoc)03.3 {04.4 stringresponseContent="";05.5 XmlNodeToUserName=xmldoc.SelectSingleNode("/xml/ToUserName");06.6 XmlNodeFromUserName=xmldoc.SelectSingleNode("/xml/FromUserName");07.7 XmlNodeContent=xmldoc.SelectSingleNode("/xml/Content");08.8 if(Content!=null)09.9 {responseContent=string.Format(ReplyType.Message_Text,FromUserName.InnerText,ToUserName.InnerText,DateTime.Now.Ticks,"欢迎使用微信公共账号，您输入的内容为："+Content.lnnerText+"\r\n<ahref=\":〃.\"点击进入</a>");}returnresponseContent;}///<summary>///普通文本消息///</summary>publicstaticstringMessage_Text{get{return@"<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[{3}]]></Content></xml>";}}

上面的代码就是接受消息，并做一些处理操作，返回消息。发送消息(图文、菜单事件响应)这边发送消息我分为三种：普通消息、图文消息和菜单事件响应。普通消息其实上面说接受消息的时候讲到了，完整的代码下边下载来看。我们先看下图文消息和菜单事件响应，微信公众平台开发者文档：：〃/wiki/index.php?title=回复图文消息#.E5.9B.9E.E5.A4.8D.E5.9B.BE.E6.96.87.E6.B6.88.E6.81.AF，xml格式为：01.1<xml>02.2<ToUserName><![CDATA[toUser]]></ToUserName>03.3<FromUserName><![CDATA[fromUser]]></FromUserName>04.4<CreateTime>12345678</CreateTime>05.5<MsgType><![CDATA[news]]></MsgType>06.6<ArticleCount>2</ArticleCount>07.7<Articles>08.8<item>09.9<Title><![CDATA[title1]]></Title><Description><![CDATA[description1]]></Description><PicUrl><![CDATA[picurl]]></PicUrl><Url><![CDATA[url]]></Url></item><item><Title><![CDATA[title]]></Title><Description><![CDATA[description]]></Description><PicUrl><![CDATA[picurl]]></PicUrl><Url><![CDATA[url]]></Url></item></Articles></xml>图文消息分为两种，我们先看下效果，找的圆通速递的微信服务号做示例：IS通邊谨88Q中爭EJf臨圆通連说IS通邊谨88Q中爭EJf臨圆通連说订野诗理VIstiB理我藍iifl戟冬葫件拦要H杵 技掘奇杵 在F噩労刚开始做的时候，我以为这两种应该不是用的同一个接口，但是在文档中找了半天也没有找到除这个之外的，就试了下两个图文消息，发现就是这个接口发送的，如果多个的话，item中的Description会失效，只会显示Title，大家试下就知道了，示例代码：viewsourceprint?01.1 //事件02.2 publicstringEventHandle(XmlDocumentxmldoc)03.3 {04.4 stringresponseContent="";05.5 XmlNodeEvent=xmldoc.SelectSingleNode("/xml/Event");06.6 XmlNodeEventKey=xmldoc.SelectSingleNode("/xml/EventKey");07.7 XmlNodeToUserName=xmldoc.SelectSingleNode("/xml/ToUserName");08.8 XmlNodeFromUserName=xmldoc.SelectSingleNode("/xml/FromUserName");09.9 if(Event!=null)10.10{//菜单单击事件if(Event.InnerText.Equals("CLICK")){if(EventKey.InnerText.Equals("click_one"))//click_one{responseContent=string.Format(ReplyType.Message_Text,responseContent=string.Format(ReplyType.Message_Text,17.1718.1819.1920.2021.2122.2223.2324.2425.2526.2627.2728.2829.2930.3031.3132.3233.3334.3435.3536.3637.3738.3839.3940.4041.4142.4243.4344.4445.4546.4647.4748.4849.4950.5051.5152.5253.5354.5455.5556.5657.5758.5859.5960.6061.6162.6263.6364.6465.6566.6667.6768.6869.6970.7071.7172.7273.7374.7475.7576.7677.7778.7879.7980.8081.8182.8283.83FromUserName.InnerText,ToUserName.InnerText,DateTime.Now.Ticks,"你点击的是click_one");}elseif(EventKey.InnerText.Equals("click_two"))//click_two{responseContent=string.Format(ReplyType.Message_News_Main,FromUserName.InnerText,ToUserName.InnerText,DateTime.Now.Ticks,"2",string.Format(ReplyType.Message_News_ltem,‘我要寄件"://./orderPlace.jpg","://./")+string.Format(ReplyType.Message_News_ltem,"订单管理","","://./orderManage.jpg","://./"));}elseif(EventKey.lnnerText.Equals("click_three"))//click_three{responseContent=string.Format(ReplyType.Message_News_Main,FromUserName.lnnerText,ToUserName.lnnerText,Dat