如何在 .Net (C#) 上将在线编辑器集成到您自己的网站中

概述

此示例将帮助您将 ONLYOFFICE 文档集成到用 .Net (C#) 编写的 Web 应用程序中。

它用于测试和演示编辑器的功能。 如果没有适当的代码修改,请不要在自己的服务器上使用此集成示例。 如果您启用了测试示例,请在投入产品之前将其禁用。

在使用测试示例时,请记住以下几方面的安全事项:

  • 由于不需要授权,因此无法保护存储免受未经授权的访问。
  • 没有检查链接中的参数替换,因为参数是由代码根据预先安排的脚本生成的。
  • 在编辑后保存文件的请求中没有数据检查,因为每个测试示例仅适用于来自 ONLYOFFICE 文档服务器的请求。
  • 没有禁止使用来自其他网站的测试示例,因为它们用于与来自另一个域的 ONLYOFFICE 文档服务器进行交互。

下载并安装 ONLYOFFICE 文档 (打包为文档服务器)。

请参阅详细指南以了解如何为 WindowsLinuxDocker安装文档服务器。

从我们的网站下载 Net (C#) / .Net (C# MVC) 示例

要将编辑器连接到您的网站,请在 settings.config 文件中指定编辑器安装的路径和存储文件夹的路径 (或 MVC 版本的 web.appsettings.config 文件):

<add key="storage-path" value=""/>
<add key="files.docservice.url.site" value="https://documentserver/" />

其中 documentserver 是安装了 ONLYOFFICE 文档服务器的服务器的名称, storage-path 是创建和存储文件的路径。您可以设置绝对路径。

如果要试验编辑器配置,请修改 DocEditor.aspx 文件中的 参数

检查您的系统是否满足要求:

  • Microsoft .NET Framework:4.5版(从 微软官方网站下载);
  • Internet Information Services:版本 7 或更高版本。

配置 IIS 组件以使服务器正常工作:

  1. 打开 Windows 功能:

    开始 -> 控制面板 -> 程序 -> 程序和功能 -> 打开或关闭 Windows 功能

  2. 在打开的窗口中,找到 Internet Information Services 并检查下图中选择的所有功能:

  1. 运行 Internet 信息服务 (IIS) 管理器:

    开始 -> 控制面板 -> 系统和安全 -> 管理工具 -> Internet Information Services (IIS) Manager

  2. 在 IIS 管理器中添加您的网站。

    Connections 面板上,右键单击树中的 Sites 节点,然后单击 Add Website

  3. Add Website 对话框中,在 Site name 框中指定带有 .Net (C#) / .Net (C# MVC) 项目的文件夹名称。

    Physical Path 框中指定项目所在文件夹的路径。

    Port 框中指定仅用于此网站的唯一端口值。

  4. 检查 IIS 管理器中为您的网站指定的 .NET 平台版本。 选择 v4.0. 版本。

    Application Pools -> 右键单击​平台名称 -> Set application Pool defaults -> .NET CLR version

  5. 使用 IIS 管理器浏览您的网站:

    右键单击网站 -> Manage Website -> Browse

如果示例和文档服务器安装在不同的计算机上,请确保安装了示例的服务器可以访问您指定地址的文档服务器,而不是配置文件中的 documentserver。 确保文档服务器能够访问安装了示例的服务器,该示例使用您在配置文件中指定的地址而不是 example.com

如果您成功集成了编辑器,结果应该类似于我们网站上的 演示预览