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 是应用程序的配置文件。
没有合适的资源?快使用搜索试试~ 我知道了~
温馨提示
【资源说明】 毕设新项目基于Python和Django开发的图书管理系统源码+sql数据库+项目说明(含演示视频).zip 项目要求: 数据库名统一使用book 注意:前端美观没有要求、但是数据保证正确 + 登录、注册(应用) + 项目应用(user) + 登录、注册页面 + 用户表(用户名、密码、………………) + 首页(应用) + 搜索框(根据书名或者作者搜索书籍)==》书籍列表页 + 书籍分类(4类或以上),点击其中一个分类,去到一个页面,展示关于这个分类的所有书籍(每页展示3本书籍即可) + 最新书籍(按照添加到数据库的时间)(展示5个)(书籍封面、书名、作者) + 图书表(需要有一个外键关联到分类表的主键)(id,书名、作者、出版社、上传时间) + 分类表(id,分类的名称) + 图书管理(增删改) + 添加图书(书名、作者、出版社) + 删除图书 + 修改图书(书名、作者、出版社) 【备注】 1、该资源内项目代码都经过测试运行成功,功能ok的情况下才上传的,请放心下载使用!有问题请及时沟通交流。 2、适用人群:计算机相关专业(如计科、信息安全、数据科学与大数据技术、人工智能、通信、物联网、自动化、电子信息等)在校学生、专业老师或者企业员工下载使用。 3、用途:项目具有较高的学习借鉴价值,也适用于小白学习入门进阶。当然也可作为毕设项目、课程设计、大作业、初期项目立项演示等。 4、如果基础还行,或者热爱钻研,亦可在此项目代码基础上进行修改添加,实现其他不同功能。 欢迎下载,沟通交流,互相学习,共同进步!
资源推荐
资源详情
资源评论
收起资源包目录
毕设新项目基于Python和Django开发的图书管理系统源码+sql数据库+项目说明(含演示视频).zip (885个子文件)
controller.ashx 3KB
ASPJson.class.asp 9KB
Uploader.Class.asp 6KB
MultiformProcessor.class.asp 4KB
PathFormatter.class.asp 3KB
action_list.asp 2KB
controller.asp 1KB
action_upload.asp 896B
action_crawler.asp 828B
config_loader.asp 543B
action_config.asp 161B
Web.config 453B
UploadHandler.cs 5KB
CrawlerHandler.cs 3KB
ListFileHandler.cs 3KB
PathFormater.cs 2KB
Handler.cs 1KB
Config.cs 1KB
NotSupportedHandler.cs 455B
ConfigHandler.cs 332B
ace.min.css 311KB
bootstrap.min.css 94KB
style.css 57KB
easyui.css 56KB
ueditor.css 43KB
font-awesome-ie7.min.css 37KB
ace-rtl.min.css 36KB
ueditor.min.css 34KB
font-awesome.css 32KB
font-awesome.min.css 27KB
ace-skins.min.css 26KB
jquery-ui-1.10.3.full.min.css 24KB
font-awesome.min.css 22KB
video-js.css 21KB
bootstrap-editable.css 21KB
select2.css 19KB
image.css 18KB
video.css 15KB
attachment.css 14KB
layer.css 13KB
chosen.css 13KB
ui.jqgrid.css 12KB
icheck.css 12KB
webuploader.css 11KB
dropzone.css 11KB
video-js.min.css 11KB
fullcalendar.css 11KB
datepicker.css 10KB
echartsHome.css 8KB
codemirror.css 8KB
shCoreDefault.css 7KB
ace-ie.min.css 7KB
zTreeStyle.css 6KB
laydate.css 6KB
daterangepicker.css 5KB
datepicker-dev.css 4KB
colorbox.css 4KB
login.css 4KB
scrawl.css 4KB
datepicker.css 4KB
laydate.css 3KB
laydate.css 3KB
datepicker.css 3KB
login.css 3KB
laydate.css 3KB
datepicker.css 3KB
book.css 3KB
codemirror.css 3KB
layer.ext.css 3KB
jquery-ui-1.10.3.custom.min.css 3KB
easyui_style.css 3KB
bootstrap-timepicker.css 3KB
charts.css 3KB
colorpicker.css 2KB
background.css 2KB
index.css 2KB
jquery.gritter.css 2KB
emotion.css 2KB
select.css 2KB
dialogbase.css 2KB
music.css 2KB
edittable.css 1KB
template.css 1KB
paging.css 925B
booklist.css 678B
webuploader.css 515B
help.css 389B
WdatePicker.css 144B
iframe.css 41B
Newtonsoft.Json.dll 471KB
fontawesome-webfont.eot 69KB
fontawesome-webfont.eot 69KB
vjs.eot 3KB
UEditorSnapscreen.exe 508KB
wface.gif 49KB
jxface2.gif 40KB
login_bgx.gif 38KB
yface.gif 28KB
bface.gif 27KB
icons.gif 20KB
共 885 条
- 1
- 2
- 3
- 4
- 5
- 6
- 9
资源评论
- ufjfi2024-01-09非常有用的资源,有一定的参考价值,受益匪浅,值得下载。
onnx
- 粉丝: 9429
- 资源: 5594
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- CheckedElectricalLiftHouseController.java
- (源码)基于Python和MySQL的数据库管理系统.zip
- (源码)基于Python的通信系统误码率计算与可视化工具.zip
- (源码)基于Qt框架的海王网咖管理系统.zip
- (源码)基于Spring Boot和Material You设计语言的论坛管理系统.zip
- (源码)基于Nio的Mycat 2.0数据库代理系统.zip
- 通过go语言实现单例模式(Singleton Pattern).rar
- 通过python实现简单贪心算法示例.rar
- C语言中指针基本概念及应用详解
- (源码)基于Websocket和C++的咖啡机器人手臂控制系统.zip
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功