MF00150-ASP.NET微信企业OA源码.zip

微信C# SDK - Redis 分布式缓存扩展模块：Senparc.Weixin.Cache.Redis.dll ================= 缓存测试地址：http://weixin.senparc.com/Cache/Test > .NET Framework 版本及 .NET Core 版本代码分别位于 [master](https://github.com/JeffreySu/WeiXinMPSDK) 和 [DotNET-Core](https://github.com/JeffreySu/WeiXinMPSDK) 分支下，结构基本保持一致，以下介绍以 .NET Framework 版本为例。 | # | 模块功能 | DLL | |--------|--------|--------| | 1 | 基础库 | Senparc.Weixin.dll | | 2 | 微信公众号 / 微信支付 / JSSDK / 摇周边 / 等等 | Senparc.Weixin.MP.dll | | 3 | ASP.NET MVC 扩展 | Senparc.Weixin.MP.MVC.dll | | 4 | 微信企业号 | Senparc.Weixin.QY.dll | | 5 | 微信开放平台 | Senparc.Weixin.Open.dll | | 6 | Redis 分布式缓存 | Senparc.Weixin.Cache.Redis.dll | | 7 | Memcached 分布式缓存 | Senparc.Weixin.Cache.Memcached.dll | 本库为.NET4.5（包括 .NET Framework 及 .NET Core），其他.NET版本请看各自分支。 * 已经支持所有微信6 API，包括自定义菜单/个性化菜单、模板信息接口、素材上传接口、群发接口、多客服接口、支付接口、微小店接口、卡券接口等等。 > （同时由于易信的API目前与微信保持一致，此SDK也可以直接用于易信，如需使用易信的自定义菜单，通用接口改成易信的通讯地址即可） * 已经支持用户会话上下文（解决服务器无法使用Session处理用户信息的问题）。 * 已经全面支持微信公众号、企业号、开放平台的最新API。 * 已经支持分布式缓存及缓存策略扩展。 目前官方的API都已完美集成，除非有特殊说明，所有升级都会尽量确保向下兼容，所以已经发布的版本请放心使用或直接升级（覆盖）最新的[DLLs](https://github.com/JeffreySu/WeiXinMPSDK/tree/master/src/Senparc.Weixin.MP.BuildOutPut)。 ## 贡献代码 > 如果需要使用或修改此项目的源代码，建议先Fork。也欢迎将您修改的通用版本Pull Request过来。 1. Fork 2. 创建您的特性分支 (`git checkout -b my-new-feature`) 3. 提交您的改动 (`git commit -am 'Added some feature'`) 4. 将您的修改记录提交到远程 `git` 仓库 (`git push origin my-new-feature`) 5. 然后到 github 网站的该 `git` 远程仓库的 `my-new-feature` 分支下发起 Pull Request 资源 ---------------- 1. 官网地址：http://weixin.senparc.com/ 2. Demo 地址：http://sdk.weixin.senparc.com/ 2. 系列教程：http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html 3. 微信技术交流社区：http://weixin.senparc.com/QA 4. 自定义菜单在线编辑工具：http://sdk.weixin.senparc.com/Menu 5. 在线消息测试工具：http://sdk.weixin.senparc.com/SimulateTool 6. 缓存测试工具：http://sdk.weixin.senparc.com/Cache/Test 7. chm帮助文档下载：http://sdk.weixin.senparc.com/Document 8. 源代码及最新更新：https://github.com/JeffreySu/WeiXinMPSDK * 技术交流QQ群（目前未满可加：3群，其他群均已满）： > 1群：300313885，2群：293958349，3群：342319110，4群：372212092，5群：377815480 > 6群：425898825，7群：482942254，8群：106230270，9群：539061281 > 10群（Redis / Memcached 分布式缓存群）：只加已经在使用的开发者。发送申请及截图至 zsu@senparc.com 或QQ：498977166，标题：Senparc.Weixin.Cache 加群申请 > 11群：553198593 * 业务联系QQ：498977166 * 新浪微博：[@苏震巍](http://weibo.com/jeffreysu1984) 如果这个项目对您有用，我们欢迎各方任何形式的捐助，也包括参与到项目代码更新或意见反馈中来。谢谢！ 资金捐助： [进入主页](http://weixin.senparc.com) ###关注测试账号（SenparcRobot）： [![qrcode]](http://weixin.senparc.com/) [qrcode]: http://sdk.weixin.senparc.com/Images/qrcode.jpg 微信公众平台开发系列教程：http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html 项目文件夹说明 -------------- | 文件夹 | 说明 | |--------|--------| |Senparc.Weixin.Cache|Senparc.Weixin.Cache.Memcached.dll 、 Senparc.Weixin.Cache.Redis.dll 等分布式缓存扩展方案| |Senparc.Weixin.MP.BuildOutPut|所有最新版本DLL发布文件夹| |Senparc.Weixin.MP.MvcExtension|Senparc.Weixin.MP.MvcExtension.dll源码，为MVC4.0项目提供的扩展包。| |Senparc.Weixin.MP.Sample|可以直接发布使用的Demo（ASP.NET MVC 4.0）| |Senparc.Weixin.MP.Sample.WebForms|可以直接发布使用的Demo（ASP.NET WebForms）| |Senparc.Weixin.MP|Senparc.Weixin.MP.dll 微信公众账号SDK源代码| |Senparc.Weixin.QY|Senparc.Weixin.QY.dll 微信企业号SDK源代码| |Senparc.Weixin.Open|Senparc.Weixin.Open.dll 第三方开放平台SDK源代码| |Senparc.Wiexin|所有Senparc.Weixin.[x].dll 基础类库源代码| Senparc.Weixin.MP.Sample中的关键代码说明 -------------- >注：这是MVC项目，WebForms项目见对应Demo中的Weixin.aspx。 ###/Controllers/WeixinController.cs 下面的Token需要和微信公众平台后台设置的Token同步，如果经常更换建议写入Web.config等配置文件（实际使用过程中两列建议使用数字+英文大小写改写Token，Token一旦被破解，微信请求将很容易被伪造！）： ```C# public readonly string Token = "weixin"; ``` 下面这个Action（Get）用于接收并返回微信后台Url的验证结果，无需改动。地址如：http://domain/Weixin或http://domain/Weixin/Index ```C# /// <summary> /// 微信后台验证地址（使用Get），微信后台的“接口配置信息”的Url填写如：http://weixin.senparc.com/weixin /// </summary> [HttpGet] [ActionName("Index")] public ActionResult Get(PostModel postModel, string echostr) { if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) { return Content(echostr); //返回随机字符串则表示验证通过 } else { return Content("failed:" + postModel.Signature + "," + MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" + "如果你在浏览器中看到这句话，说明此地址可以被作为微信公众账号后台的Url，请注意保持Token一致。"); } } ``` 上述方法中的PostModel是一个包括了了Signature、Timestamp、Nonce（由微信服务器通过请求时的Url参数传入），以及AppId、Token、EncodingAESKey等一系列内部敏感的信息（需要自行传入）的实体类，同时也会在后面用到。 下面这个Action（Post）用于接收来自微信服务器的Post请求（通常由用户发起），这里的if必不可少，之前的Get只提供微信后台保存Url时的验证，每次Post必须重新验证，否则很容易伪造请求。 ```C# /// <summary> /// 用户发送消息后，微信平台自动Post一个请求到这里，并等待响应XML /// </summary> [HttpPost] [ActionName("Index")] public ActionResult Post(PostModel postModel) { if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) { return Content("参数错误！"); } ... } ``` ###如何处理微信公众账号请求？ Senparc.Weixin.MP提供了2中处理请求的方式，[传统方法](https://github.com/JeffreySu/WeiXinMPSDK/wiki/处理微信信息的常规方法)及使用[MessageHandler](https://github.com/JeffreySu/WeiXinMPSDK/wiki/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8MessageHandler%E7%AE%80%E5%8C%96%E6%B6%88%E6%81%AF%E5%A4%84%E7%90%86%E6%B5%81%E7%A8%8B)处理方法（推荐）。上面两个方法在wiki中已经有比较详细的说明，这里简单举例MessageHandler的处理方法。 MessageHandler的处理流程非常简单： ``` C# [HttpPost] [ActionName("Index")] public ActionResult Pos