[翻译]FCKeditor 在ASP.Net 中的使用说明

原文 http://wiki.fckeditor.net/Developer%27s_Guide/Integration/ASP.Net

在ASP.Net 中的使用说明

 

FCKeditor 是一个运行在浏览器上的 JavaScript 应用程序。他可以不依赖任何服务器端语言运行。不过,更好的使用方法是你使用一种服务器端语言来调用他。

在ASP.Net 中,有一个现成的工具包可以让你把 FCKeditor 作为一个WebForms控件使用。这个工具包叫FCKeditor.Net。

要在你的 ASP.Net web 页面中使用他,请按照以下步骤执行。

前提条件

在进行以下几步前,你必须已经下载并且安装了最新版本的FCKeditor编辑器工具包(将他COPY到你的网站)。FCKeditor.Net 工具包并不包含FCKeditor编辑器的代码。(将编辑器JavaScript代码放到你网站的/FCKeditor/ 目录)。你能从下面的地址下载到编辑器:
http://sourceforge.net/project/showfiles.php?group_id=75348&package_id=75845

第一步

确保编辑器已经在你网站的 “/FCKeditor/” 目录里。现在,你需要下载FCKeditor ASP.Net 控件的DLL文件到你的页面。你能在下面的地址找到最新的版本:

http://sourceforge.net/project/showfiles.php?group_id=75348&package_id=137125

第二步

在下载的ZIP文件中包含控件的源代码和一个已经编译好的文件(”bin/Release/FredCK.FCKeditorV2.dll”)。大多少情况下,你并不需要对源代码做任何改变。你仅仅需要在你的项目中引用编译好的DLL文件,引用有2个方法:

手动复制FredCK.FCKeditorV2.dll 文件到你网站的”bin”目录
在你的Visual Studio.Net项目中按右键并选择“添加引用” ,从你保存FredCK.FCKeditorV2.dll 文件的地方选择他。
你也可以直接在Visual Studio.Net工具箱中包含这个控件,在工具箱中右键,选择“添加项”,然后,选择FredCK.FCKeditorV2.dll 。
确保你已经有了最新的DLL文件版本。
第三步

现在就可以在你的网站上使用他了,新建一个ASP.Net页面,在页面上创建一个实例,有2个方法:

把控件从工具箱中拖到你的页面(如果你已经在“第二步”中把他加到你的工具箱)
在你的ASP.Net页面顶部包含以下代码:
<%@ Register TagPrefix=”FCKeditorV2″ Namespace=”FredCK.FCKeditorV2″ Assembly=”FredCK.FCKeditorV2″ %>

并且在

中添加控件的标签: 

注意: BasePath 属性所指定的目录就是FCKeditor 所在的目录

全部代码如下

<%@ Page ValidateRequest=”false” Language=”VB” AutoEventWireup=”false” %>

<%@ Register TagPrefix=”FCKeditorV2″ Namespace=”FredCK.FCKeditorV2″ Assembly=”FredCK.FCKeditorV2″ %>

 

 

   FCKeditor – Sample

   

 

 

   

 

     


     

   

 

 

 

文件浏览和上传

为了方便上传文件和图片到服务器,FCKeditor拥有文件管理和快速上传功能。

FCKeditor的这个功能依赖于服务器端的语言。你只需要为你使用的那种语言做简单的设置。为了在ASP.Net中使用,你要打开FCKeditor目录中的fckconfig.js 文件,找到_FileBrowserLanguage 和 _QuickUploadLanguage ,并将他们的值设置为’aspx’ 。

你的网站必须有上传文件的权限,还要预先设置好上传目录。默认情况下, FCKeditor.Net 会在网站的根目录下查找UserFiles 目录,并把所有文件都放到这里,所以要先建好这个目录 。

注意: 需要给予ASPNET 和/或者 IUSR_ 用户对UserFile目录的文件/目录的写和创建权限。

示范

你可以在FCKeditor.Net 工具包的”_samples/aspx”目录中找到一些告诉你如何使用的示范文件。把这个目录复制到FCKeditor安装的同一个目录就可以使用了。

最小安装示范

这是一个假设的在ASP.Net网站中使用FCKeditor 的情况

 

我们可以看到,这个网站包括:

FredCK.FCKeditorV2.dll 文件, 从FCKeditor.Net 工具包中复制到网站根目录中的bin 目录里。 (查看 “第一、第二步”)
FCKeditor 目录,编辑器的JavaScript代码(来自FCKeditor 工具包). (查看 “前提条件”)
UserFiles 目录,放置用户上传文件的地方
MyPage.aspx 页,包含上面演示如何使用编辑器的代码。 (查看 “第三步”)
小技巧

你可以在web.config 配置文件中设置默认的UserFiles 路径,这样,在你网站里使用的所有FCKeditor 编辑器都可以使用这个设置:

 

 

 

ASP.Net 1.1 和 2.0

在使用FCKeditor 的页面,需要把ValidateRequest 属性为false:

<%@ Page Language=”VB” Inherits=”FredCK.FCKeditorV2.FileBrowserConnector” AutoEventWireup=”false” ValidateRequest=”false” %>

这是因为由编辑器建立的一些输入会被.Net Framework认为有危险。

ASP.Net 2.0 和主题

如果你正在使用Asp.net 2.0 和主题:你必须打开\editor\filemanager\upload\aspx\upload.aspx 和、\editor\filemanager\browser\default\connectors\aspx\connector.aspx  并且在第一行添加或者修改Theme=”” :

<%@ Page Language=”VB” Inherits=”FredCK.FCKeditorV2.FileBrowserConnector” AutoEventWireup=”false” Theme=”” %>

在代码中修改UserFilesPath

如果你想修改用户上传文件的路径,你并不需要动态加载控件,但你需要在page init 中做一些操作,(并不是在page load 中)。下面是一个例子:

Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init

Session(“FCKeditor:UserFilesPath”) = “~/App_Images/” & _teamName

End Sub

在代码中动态添加编辑器

把Base path 设置在 web.config 文件中:

例如,如果下面是FCKeditor 所在目录”c:/inetpub/wwwroot/virtualdir/FCKeditor/” ,这样添加:

 

可以使用session 来设置UserFilesPath 的路径,需要在你添加控件前设置session 变量。

Session(“FCKeditor:UserFilesPath”) = “/virtualdir/userfiles/”

可以使用request 对象来设置BasePath。假设当前路径是: “http:///FCKEditor/”。

FCKeditor1.BasePath = Request.ApplicationPath + “/FCKEditor/”;

添加控件到页面:

Dim fckeditor As New FredCK.FCKeditorV2.FCKeditor

fckeditor.ImageBrowserURL = “http://localhost/virtualdir/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/aspx/connector.aspx”

fckeditor.ID = “dynamicname”

fckeditor.Value = “the text you want in the FCK editor”

fckeditor.SkinPath = “skins/silver/”

fckeditor.ToolbarSet = “Default”

myForm.Controls.Add(fckeditor)

 

张贴在C#

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注