syncfusion-aspnetmvc-docx-editor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Syncfusion ASP.NET MVC DOCX Editor

Syncfusion ASP.NET MVC DOCX 编辑器

Overview

概述

This skill helps developers generate ASP.NET MVC (C#) code for integrating the Syncfusion DOCX Editor into their applications. It provides ready-to-use snippets and best practices for embedding a Document Editor that supports editing, reviewing, formatting, and more.

本技能帮助开发者生成用于在ASP.NET MVC（C#）应用中集成Syncfusion DOCX Editor的代码，提供可直接使用的代码片段和最佳实践，用于嵌入支持编辑、审阅、格式化等功能的文档编辑器。

Key Capabilities

核心功能

Document Editing: Create, edit, and view Word documents.
Protection: Apply read-only mode, allow comments, allow form filling, enforce tracked changes,and define editable ranges.
Review: Enable track changes (revisions) and accept/reject changes.
Comments: Add comments, replies, and author metadata.
Find and replace: Perform programmatic find and replace operations for automation.
Form Fields: Insert and fill text fields, check boxes, and dropdown form fields.

文档编辑：创建、编辑和查看Word文档。
保护功能：应用只读模式、允许批注、允许表单填充、强制修订跟踪以及定义可编辑范围。
审阅功能：启用修订跟踪（版本变更）并接受/拒绝变更。
批注：添加批注、回复和作者元数据。
查找替换：执行程序化的查找和替换操作以实现自动化。
表单字段：插入并填写文本字段、复选框和下拉表单字段。

Prerequisites

前置要求

NuGet package:
```
Syncfusion.EJ2.WordEditor.AspNet.Mvc5
```
(or framework-specific wrapper)
Syncfusion License: https://www.syncfusion.com/products/communitylicense

NuGet包：
```
Syncfusion.EJ2.WordEditor.AspNet.Mvc5
```
（或对应框架的包装器）
Syncfusion许可证：https://www.syncfusion.com/products/communitylicense

Quick Start Examples

快速入门示例

Example 1: Create an editable Document Editor with Ribbon

示例1：创建带功能区的可编辑文档编辑器

User: "Create a Document Editor component with Ribbon UI"

Result: An ASP.NET MVC snippet that renders the Document Editor with Ribbon UI.

用户：“创建带功能区UI的Document Editor组件”

**结果：**一段渲染带功能区UI的Document Editor的ASP.NET MVC代码片段。

Example 2: Enable Read‑Only Restriction Mode

示例2：启用只读限制模式

User: "Create a Document Editor with Read‑Only restriction mode."

Result: An ASP.NET MVC snippet that creates a Document Editor with read‑only protection enabled.

用户：“创建带只读限制模式的Document Editor”

**结果：**一段创建启用只读保护的Document Editor的ASP.NET MVC代码片段。

Getting Started — Minimal ASP.NET MVC (C#) Code

快速上手——最简ASP.NET MVC（C#）代码

Minimal ASP.NET MVC Document Editor setup for plain web project:

Add the Syncfusion<sup style="font-size:70%">®</sup> ASP.NET MVC DocumentEditor tag helper in

~/Views/Home/Index.cshtml

page.

For example, the Document Editor Container component is added to the

~/Views/Home/Index.cshtml

page.

cshtml

@Html.EJS().DocumentEditorContainer("container").Render()

适用于普通Web项目的最简ASP.NET MVC Document Editor设置：

在

~/Views/Home/Index.cshtml

页面中添加Syncfusion<sup style="font-size:70%">®</sup> ASP.NET MVC DocumentEditor标签助手。

例如，将Document Editor Container组件添加到

~/Views/Home/Index.cshtml

页面：

cshtml

@Html.EJS().DocumentEditorContainer("container").Render()

Generate ASP.NET MVC (C#) Code for the User's Project

为用户项目生成ASP.NET MVC（C#）代码

Trigger keywords: "code", "snippet", "how to", "show me", "sample", "example code", "generate code", "implement", "add to view", "configure documenteditor", "create", "asp.net mvc document editor", "docx editor", "document editor", "track changes", "load docx", "export pdf", "comments", "accept changes", "insert table", "insert image", "table of contents", "protect document", "content control"

Workflow:

Analyze the user's request to identify the feature (e.g., track changes, restrict editing, toolbar customization).
Read the relevant
```
references/*.md
```
file(s) to understand the APIs and code patterns for the requested feature.
STOP before generating code. Check if the user has already chosen a delivery mode.
If no delivery mode is chosen yet, you MUST ask the user first using this concise multiple-choice question:

"How would you like to receive the generated code?"
- Option 1: Replace the code in a specific project file (you'll need to provide the file path and confirm)
- Option 2: Share the code directly in the chat window
Only after the user selects a delivery mode, proceed to generate ASP.NET MVC (C#) code using the APIs and snippets from
```
references/*.md
```
, substituting concrete placeholders from the user's project.
Do NOT make changes to workspace project files unless the user explicitly chose Option 1 and provided the file path with permission.
Provide complete ASP.NET MVC snippets and concise integration steps after delivering the code.

Refer to
## Key Rules
section for operational constraints (output directory, temporary files, allowed libraries, etc.)

触发关键词："code"、"snippet"、"how to"、"show me"、"sample"、"example code"、"generate code"、"implement"、"add to view"、"configure documenteditor"、"create"、"asp.net mvc document editor"、"docx editor"、"document editor"、"track changes"、"load docx"、"export pdf"、"comments"、"accept changes"、"insert table"、"insert image"、"table of contents"、"protect document"、"content control"

工作流程：

分析用户请求，确定所需功能（如修订跟踪、编辑限制、工具栏自定义）。
阅读相关
```
references/*.md
```
文件，了解请求功能对应的API和代码模式。
生成代码前请暂停。检查用户是否已选择交付方式。
如果用户尚未选择交付方式，必须先使用以下简洁的选择题询问用户：

“您希望以何种方式接收生成的代码？”
- **选项1：**替换特定项目文件中的代码（需提供文件路径并确认）
- **选项2：**直接在聊天窗口中分享代码
仅在用户选择交付方式后，使用
```
references/*.md
```
中的API和代码片段生成ASP.NET MVC（C#）代码，替换用户项目中的具体占位符。
除非用户明确选择选项1并提供带权限的文件路径，否则请勿修改工作区项目文件。
交付代码后，提供完整的ASP.NET MVC代码片段和简洁的集成步骤。

有关操作限制（输出目录、临时文件、允许使用的库等），请参考
## 关键规则
部分

Code References

代码参考

All code snippets and examples are in the

references/

folder. Each file contains:

Minimal ASP.NET MVC (C#) Code — a working, ready-to-use snippet
Placeholders — values the user must customize
Notes — ASP.NET MVC best practices and framework-specific adaptations

File	Topic
comments.md	Insert, Manage, and Delete Comments
customize-toolbar.md	Customize Toolbar Items
getting-started.md	Initialize Document Editor (Razor/Cshtml)
document-protection.md	Protect and Restrict Document Editing
editor-only.md	Editor-only mode initialization
find-and-replace.md	Find and Replace Text
form-fields.md	Create and Manage Form Fields
paste-formatting.md	Preserve paste formatting (server-side)
ribbon.md	Initialize documentEditor with Ribbon UI
track-changes.md	Track Changes and Manage Revisions

所有代码片段和示例均位于

references/

文件夹中。每个文件包含：

最简ASP.NET MVC（C#）代码——可直接运行的可用代码片段
占位符——用户必须自定义的值
说明——ASP.NET MVC最佳实践和框架适配方案

文件名称	主题
comments.md	插入、管理和删除批注
customize-toolbar.md	自定义工具栏项
getting-started.md	初始化文档编辑器（Razor/Cshtml）
document-protection.md	保护和限制文档编辑
editor-only.md	仅编辑器模式初始化
find-and-replace.md	查找和替换文本
form-fields.md	创建和管理表单字段
paste-formatting.md	保留粘贴格式（服务器端）
ribbon.md	初始化带功能区UI的DocumentEditor
track-changes.md	修订跟踪和版本变更管理

Key Rules for Code Generation

代码生成关键规则

No inline code in SKILL.md — Always point to snippets in
```
references/*.md
```
. This file is loaded into context for every prompt; inline code wastes tokens.
Snippets must be tested — All code must compile and run against the current
```
Syncfusion.EJ2.WordEditor.AspNet.Mvc5
```
Minimal Code + Placeholders + Notes — Every reference file must include:
- Minimal Code (complete, working snippet)
- Placeholders (values user must substitute — marked with
```
{{ }}
```
  or
```
[PLACEHOLDER]
```
  )
- Notes (best practices, framework-specific adaptations, constraints)
Use only Syncfusion APIs — Never suggest competing libraries
Share code and notes for the requirement — Never create temporary files or scripts.
License handling — Never hardcode license keys. Point user to environment variables or config files.
Framework adaptation — Default to plain JavaScript/TypeScript. When user specifies framework.
No hallucinated APIs — Use only verified Syncfusion DOCX Editor SDK method names. One wrong method breaks user trust.

SKILL.md中禁止内嵌代码——始终指向
```
references/*.md
```
中的代码片段。本文件会加载到每个请求的上下文环境中，内嵌代码会浪费令牌资源。
代码片段必须经过测试——所有代码必须能够针对当前版本的
```
Syncfusion.EJ2.WordEditor.AspNet.Mvc5
```
编译并运行。
最简代码 + 占位符 + 说明——每个参考文件必须包含：
- 最简代码（完整、可运行的代码片段）
- 占位符（用户必须替换的值——标记为
```
{{ }}
```
  或
```
[PLACEHOLDER]
```
  ）
- 说明（最佳实践、框架适配方案、限制条件）
仅使用Syncfusion API——绝不推荐竞争类库。
仅分享符合需求的代码和说明——绝不创建临时文件或脚本。
许可证处理——绝不硬编码许可证密钥。引导用户使用环境变量或配置文件。
框架适配——默认使用纯JavaScript/TypeScript。当用户指定框架时进行适配。
禁止虚构API——仅使用经过验证的Syncfusion DOCX Editor SDK方法名称。错误的方法会破坏用户信任。

Rules

通用规则

Only use Syncfusion Document Editor APIs — never recommend or use alternative Word Editor libraries.
No temporary files — never create temporary scripts, intermediate files, or scaffolding outside the output directory
ASP.NET MVC (C#)-only code — all generated code must be valid ASP.NET MVC (C#), never generate vanilla JavaScript, jQuery, or non-ASP.NET MVC (C#) patterns

仅使用Syncfusion Document Editor API——绝不推荐或使用其他Word编辑器类库。
禁止临时文件——绝不创建临时脚本、中间文件或输出目录之外的脚手架文件。
仅生成ASP.NET MVC（C#）代码——所有生成的代码必须是有效的ASP.NET MVC（C#）代码，绝不生成原生JavaScript、jQuery或非ASP.NET MVC（C#）模式的代码。