UEditor ASP.NET 后台使用说明
=====
## 背景
UEditor 在 1.4 版本之后进行了一次[前后端统一配置](../_doc/3.1 后端请求规范.md)的整理,.Net 的后台也进行了一次重写,跟之前的版本差别较大,升级的用户注意阅读本文档。
本文档介绍 UEditor ASP.NET 后台的部署、配置、源码说明。
## 1. 部署说明
### 1.1. 安装并注册 .NET Framework 4.0
代码的运行时环境是 .NET Framework 4.0,首先要确认 IIS 已经安装了 .NET 4.0 的运行时框架。方法是打开「IIS 管理器」,选择根目录下的「应用程序池」,在右侧查看是否有一个应用程序池的版本是 v4.0,如果存在,则 IIS 已经安装了所需的运行时环境,此时读者可以跳过本节。
![检查 .NET 4.0 安装情况](../_doc/images/net-publish-1.png)
如果没有找到对应的应用程序池,需要手动安装。
Windows 7 和 Windows Server 2008 R2 默认安装了 .Net Framework 4.0,如果是 Server 03 和老掉牙的 Windows XP,则需要手动安装 [.NET Framework 4.0](http://www.microsoft.com/zh-cn/download/details.aspx?id=17718)。
安装完 .NET Framework 4.0 后,还需要向 IIS 注册应用程序池,注册的方法是,使用**管理员权限**打开命令提示符(CMD),输入以下命令:
```shell
C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -i
```
安装完毕后,在 IIS 管理器刷新就能看到 4.0 的应用程序池。
### 1.2. 设置 .NET 应用程序
代码要求以应用程序的形式来运行(可以方便加入库依赖和组织代码)。需要把 `net` 目录转换为应用程序。
1. 在 IIS 中,展开到 `ueditor/net` 目录,在目录上右击,点击「转换为应用程序」。
![转换为应用程序](../_doc/images/net-publish-2.png)
2. 弹出的对话框中,点击「选择...」来指定使用的应用程序池。选择版本为 4.0 的应用程序池,然后点确定。
![选择应用程序池](../_doc/images/net-publish-3.png)
3. 设置连接凭据。点击「链接为...」按钮,在弹出的对话框中指定一个对目录具有读写权限的用户(如 administrator),然后点确定。
![设置连接凭据](../_doc/images/net-publish-4.png)
设置完毕后,可以点击「测试设置...」来测试权限是否正常。
![设置连接凭据](../_doc/images/net-publish-5.png)
### 1.3. 运行测试
在浏览器中运行 `net/controller.ashx`,如果返回 "`{"state":"action 参数为空或者 action 不被支持。"}`",则表示应用程序运行成功。
如果你确认上述步骤已经执行,但是依然有问题,请给我们[提 Issue](https://github.com/fex-team/ueditor/issues/new?labels=NET%E5%90%8E%E5%8F%B0),我们会尽快答复解决。
## 2. 配置说明
前后端配置统一之后,配置文件由后台读取,返回给前端。但是部分配置是给后台使用的。
### 2.1. 上传配置说明
关于上传的部分,后台需要关心以下模板的配置项。
```json
{
"{tpl}FieldName": "upfile",
"{tpl}PathFormat": "upload/{tpl}/{yyyy}{mm}{dd}/{time}{rand:6}",
"{tpl}UrlPrefix": "/ueditor/net/",
"{tpl}AllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"],
"{tpl}MaxSize": 2048000
}
```
"{tpl}FieldName" 表示提交的表单的文件域名称。
"{tpl}PathFormat" 表示上传文件保存的路径和名称。注意,这里的路径是相对应用程序的,如果需要修改的话,请自行修改源码。
"{tpl}UrlPrefix" 表示上传文件访问的 URL 前缀。注意,这里应该给出应用程序的 URL 路径,否则上传的文件不能正确定位。
> 举个例子,如果你的 UEditor 的位置在 `http://www.mydomain.com/myapp/ueditor`,对应的本地路径是 `C:\iis_pub\www\myapp\ueditor`,那么 .NET 应用程序的位置在 `http://www.mydomain.com/myapp/ueditor/net`,对应的本地路径是 `C:\iis_pub\www\myapp\ueditor\net`。图片上传配置项应该如下:
>
> {
> "imagePathFormat": "upload/image/{yyyy}{mm}{dd}/{time}{rand:6}",
> "imageUrlPrefix": "/myapp/ueditor/net/",
> }
>
> 上传的文件会保存在 `C:\iis_pub\www\myapp\ueditor\net\upload\image\{日期}\{文件名}`
"{tpl}AllowFiles" 限制文件上传的类型,注意要有 "."。
"{tpl}MaxSize" 限制文件上传的大小。注意这里的限制是代码上的判断,应用程序本身还有一个请求报文大小限制。该限制在 web.config 文件中修改,注意要有以下的节:
```xml
<configuration>
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="102400" />
</system.web>
</configuration>
```
maxRequestLength 就是请求报文大小限制,该大小应该要比设置的所有上传大小都大,否则应用程序执行之前,请求会被被拒绝。
## 3. 源码说明
可以看到 net 目录内的源码结构是这样的:
```
net
App_Code
Config.cs
Handler.cs
PathFormatter.cs
*Handler.cs
Bin
Newtonsoft.Json.dll
config.json
controller.ashx
net.sln
README.md
Web.config
```
App_Code 上的文件是应用程序的源码。
- Config.cs 负责读取配置文件
- Handler.cs 是请求处理器的基类,提供了一些基本对象的访问以及输出控制。如果需要增加处理器,应该从该基类继承
- PathFormatter.cs 解析 PathFormat,把信息填充为运行时信息。
- *Handler.cs 是各种处理器,处理各种 UEditor 需要的请求。
Bin 里面的是应用程序的依赖库,当前依赖 Newtonsoft 的 Json 库。Bin 目录和 App_Code 目录受应用程序保护,不用担心被用户访问到。
config.json 是 UEditor 后端的配置文件,上一节已经介绍了比较重要的配置项。
controller.ashx 是 UEditor 请求的入口,它把不同的 action 分发到不同的 Handler 来处理。
net.sln 是项目的解决方案文件,安装 Visual Studio 2013 或以上的机器可以打开进行项目的改造。
README.md 是本说明文件。
Web.config 是应用程序的配置文件。
没有合适的资源?快使用搜索试试~ 我知道了~
资源推荐
资源详情
资源评论
收起资源包目录
基于SSM的微信小程序商城系统源码.zip (1938个子文件)
010f2d8b9783b56e9f31e05b1565d567bb9abf 185KB
0120c0383bdaa5700a5cc7fb5d86820d2a9d77 906B
0273c7296cb779cad7086bb71a005069c21688 2KB
02e4d8faf41ab4b4143fcdfaa115bf0c9fb58e 66B
0307789d5645705a2df9be654b9f47b5c6f059 137B
030b3ac1b80d2c17fda4ea330f7dca302272a0 562B
0344b649f60a4feb17ca4bb3e76a516705d0ed 181B
0441ba83d116ef015ecfa050523bd8df972199 531B
04b4fa76402c9a21715d14a4ac40652fd3d191 4KB
0556b9df9f444456b96b5656b8b8f10131c11c 1KB
0637540f5914fbc51b4b817e8e00b09a8d3fbb 54B
0c7517353948e882e8bbdf73c466275faa835c 121KB
0e3ce9c39ad9957bdf495b27c4f15648f2d3df 54B
0e9a15ef7bf9c6ac3a84c6e34d35e839060e43 375B
11cf5915e00886d29a372d1b540085f7288c96 724B
132e70fba1eb365d70ca2d59643d3bf0fbcefa 510B
13578e4e2ec5a06b1ed399c7ba58f3555be39c 479B
1acc95bbc205bf7c6197b72a3e30fb969bf1fb 14KB
1dc061d2504e24138fd491e4e84c46855efc11 51B
1ece649d76656783eeba6490990f7951e6b1bc 55B
1eda6acf88ff206aabd8060ede1b9514c78a11 545B
20d39d8d4484c1cafd7f6cf7dc761cf4d1edb8 802B
22119735e66678cd45c204a70193be8205038f 7KB
24eb49e2d18a4e54838b67d662ba570e71fe12 59KB
256b4708908160386b3beb2117c4c852d27ca4 173B
25c3893ad1b6b1a48961634a2aa77188b52dfe 1KB
26dfeeb6e641a33dae4961196235bdb965b21b 17B
28fbfa4abc3402edcf5d9de3881dafb34bbc6c 704B
291012b58dc41e0f8edf32af9d794845152b57 874B
296813e7ab92932545075fe77626a2ad134412 92KB
29dcdb9d0dae07f398fcab9f72ce9d86aa0274 681B
2a3d8effd89705644a519317b02a35638cf2aa 545B
2bfe1e1637e71e50fa4f9b2ef8622c66213942 605B
2ee7de62370a2940a2ca0228abe2b41298b20a 78B
31154e7203a9278ab75d5f018af01ac987094b 62B
325b695c1f09c2f4c30743444c8eda70bc1dce 1KB
33ff7e7d61c3cae76014c8da88064dc74bc2af 9KB
3416bafe030f21385f05e10497f98fd6cb2a0a 378B
36cc26c933c0b623ed78201735ea49477ed9cf 61B
386dc05f540527ac70bfa2b23b408b7693bf33 217B
389e02e5a9f7bceb92d662093896ce0588782b 4KB
38fc3da911001c558c8aedb51806e33ae696c8 1KB
39f7d803cb7a56682fa713e1afa6977b7ff8c3 602B
3a609d6b7dd14986b5339f2fe4d750bbff8ec9 376B
3a9955eb30e210f9bebdddc29e3a166c6c1dfc 4KB
3c2f6cc6a0122e0d2c8e9fb8a8955335bed098 51B
3c3bd630ead0bd49dd8c8d6564fff7063c1e52 1KB
3dccd0bf1eee00408e189e65aab4bd11edef5d 261B
3ebe40b8f6607ef76a58643ac92d4ce008585f 194B
3eec58133ea43fbd349c973867cf2f7c59f541 540B
40df0101f55033e7f0631715b632d9accabe05 134B
44b8645b2ff24c7cfcbcf93b54ed1dcae2b986 594B
45c13ba873ff931fe7079bb0defb7bde22abc7 137B
4704c7e29cc0d3a5c3a9fb2c4205796b6a79a5 379B
472f9b44591ee93c528e8e2db89d6ca1fef19f 47B
488aa417c8f35f078231bdf28d0e2e94b79096 378B
48dfe80ebced40b31fd55cf74b93e971ea1162 29KB
49694f83ea1b104e12b36774d5c5d3db50bcb0 46B
4bdf8fce78203823aa5344e8f6d73424c5ae52 292B
4bf9c50a4568c635f6060da8685f4194e77395 479B
4c08312c1045109956ed0c91b094207fd35603 65B
4d1b6743a09f039fa7b0709ee1c9b41f5772ad 384B
4ef3d62d741e1131da9a7bca809cf53f4f82da 52B
50b81fc7b13c72abd173df5834076c15b4f8f8 293B
511b1f76bd740d077c7dc18341bf1b9dcf5e33 382B
517e69adc2a58e4fd1c1712b02c56fe3de6372 1KB
522b60f93b32981a2a9544a1a5b5280fb090d2 4KB
537e102ed56c5ff81e20c87686d8844654024e 37KB
54fb01aa8e1150507780111e88491c84fbf0fd 905B
564020adf96ce9c5704420708fdc4689c80d33 2KB
5a96c900dc3898767575ea09d098e82d283075 49B
5be98b1b2d79ea8f34eb42ab918bec19c13632 788B
5c1696c7885433d0881ebbe898517dc27043d7 443B
5c385f731d350460261870fd74b317f1bc9925 4KB
5ecb051d1393881d039d3985d9e4e545465012 63B
5f67b2f29a6509871a9c8d6a9675a167f93bb3 41KB
5f914222d0f021f1a76af853f909cb894c0dfb 1KB
60e81acf31c90199e90110cae9f8df7b961021 340B
616eff75aa29cfc4f18d424251aa03e2e01eea 10KB
62b13bee221538899b2b807269cdda0926d465 134B
62e7fbcf5f722d3de413911acb299fcaebc6d4 133B
64c4b8eacdb55d4c6a5ddf52d4ac62dba5f5d8 50B
64ff2a0be2571a84b5b5160d2e41fe84dfd331 382B
66506fa1fd0325f8ac25623dcc75651ebedac9 133B
67780f3b987f5e1562919e412fd02c214fcf38 793B
6808c92b1fb6346413952cb9619cd414245af9 1KB
69c26f16f5331d6a2b8c5d52d449d432815cc8 47B
6b013a75cb0fb96aa2b518838c63f225bf4e71 575B
6c4027fd8bae1dac9648d4d7fdc9533537d84a 1KB
6e601e365935eba783ab28cc94096be9e245da 3KB
6fa848f58707bbaad3bb263154b5a01ef0140c 104B
70a1ca2c60b28846c5dbfd75de92dbb7d398e7 1KB
715e045fdb63f753dd5913a319d6c4c5103fcb 4KB
71cb24516850fbbf97d476415cef8753d7def2 135B
727fa0a21063b6ed69400881852fd21a80e2c6 466B
73f59aecf381a0db3becf957c924dc627f3684 835B
74c04af6f2092f7aec9eae8e47d3c02094be51 71KB
757c0f0c03efea2219f4df1c4dcd20015a1832 65B
75e568fa40401e37c6f7abf508b7f0982147be 66B
762424183b2777f401f1b3a89aec9aa24c5ce5 372B
共 1938 条
- 1
- 2
- 3
- 4
- 5
- 6
- 20
资源评论
老了敲不动了
- 粉丝: 77
- 资源: 4289
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- 基于python实现的三次样条插值和均值插值法实现
- Python语言教程2-python批量图片大小处理-多文件夹
- Python语言教程1-python批量图片重命名,将后缀某几个不想要的字去除
- Space Combat Kit 太空战斗套件Unity游戏开发插件资源unitypackage C#
- Universal Device Preview 通用设备预览Unity游戏开发插件资源unitypackage
- Paladin Anim Set 圣骑士动画集Unity游戏动作动画插件资源unitypackage
- 计算机财务管理期末考报表部分题目及答案.doc
- 计算机软件维护论文.doc
- 计算机软件著作权授权书.docx
- 计算机键盘教学案例.doc
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功