C# 创建可填充Word表单

2025-01-08 技术教程

背景介绍

有时候，我们需要制作一个Word模板文档，然后发给用户填写，但我们希望用户只能在指定位置填写内容，其他内容不允许编辑和修改。这时候我们就可以通过表单控件来轻松实现这一功能。
本文将介绍如何使用C#在Word文档中创建可填充的Word表单。

使用工具

• Visual Studio
• Spire.Doc for .NET组件

在添加以下代码前，需要下载Spire.Doc组件，并从安装路径下的bin文件夹中引用Spire.Doc.dll到程序中。

代码

在Word中，表单控件主要分为两种：

• 旧式窗体域
• 内容控件（Word 2010及以后版本）

下面看看如何使用Spire.Doc添加旧式窗体域和内容控件到Word模板文档。

添加旧式窗体域

Word 2007及以前的版本中是旧式窗体域。旧式窗体域分为：文本型窗体域、复选框型窗体域和下拉型窗体域。

下面的代码创建了一个Word文档，然后添加了一个表格，并给表格添加文本型、复选框型和下拉型窗体域，最后保护Word文档。

{//创建Document实例Document doc = new Document();//添加一个sectionSection section = doc.AddSection();//标题Paragraph title = section.AddParagraph();TextRange titleText = title.AppendText("职位申请表");titleText.CharacterFormat.FontName = "宋体";titleText.CharacterFormat.FontSize = 16f;title.Format.HorizontalAlignment = HorizontalAlignment.Center;//添加一个7行2列的表格Table table = section.AddTable(true);table.ResetCells(7, 2);//合并首行的单元格table.ApplyHorizontalMerge(0, 0, 1);//设置表头TableRow headerRow = table.Rows[0];headerRow.IsHeader = true;headerRow.RowFormat.BackColor = Color.FromArgb(0x00, 0x71, 0xb6);headerRow.Cells[0].CellFormat.VerticalAlignment = VerticalAlignment.Middle;Paragraph headerParagraph = headerRow.Cells[0].AddParagraph();TextRange headerText = headerParagraph.AppendText("第一部分、个人信息");headerText.CharacterFormat.Bold = true;//添加段落到单元格[1,0]Paragraph paragraph = table.Rows[1].Cells[0].AddParagraph();TextRange textRange = paragraph.AppendText("姓名");//添加文本型窗体到单元格[1,1]paragraph = table.Rows[1].Cells[1].AddParagraph();AddTextFormField(paragraph, "Name");//添加段落到单元格[2,0]paragraph = table.Rows[2].Cells[0].AddParagraph();textRange = paragraph.AppendText("年龄");//添加文本型窗体到单元格[2,1]paragraph = table.Rows[2].Cells[1].AddParagraph();AddTextFormField(paragraph, "Age");//添加段落到单元格[3,0]paragraph = table.Rows[3].Cells[0].AddParagraph();textRange = paragraph.AppendText("婚否");//添加复选框型窗体到单元格[3,1]paragraph = table.Rows[3].Cells[1].AddParagraph();AddCheckBoxFormField(paragraph, "Married");//添加段落到单元格[4,0]paragraph = table.Rows[4].Cells[0].AddParagraph();textRange = paragraph.AppendText("专业");//添加下拉型窗体到单元格[4,1]paragraph = table.Rows[4].Cells[1].AddParagraph();AddDropDownFormField(paragraph, "Major");//添加段落到单元格[5,0]paragraph = table.Rows[5].Cells[0].AddParagraph();textRange = paragraph.AppendText("申请职位");//添加文本型窗体到单元格[5,1]paragraph = table.Rows[5].Cells[1].AddParagraph();AddTextFormField(paragraph, "Position");//添加段落到单元格[6,0]paragraph = table.Rows[6].Cells[0].AddParagraph();textRange = paragraph.AppendText("申请理由");//添加文本型窗体到单元格[6,1]paragraph = table.Rows[6].Cells[1].AddParagraph();AddTextFormField(paragraph, "Reason");//创建段落样式ParagraphStyle style = new ParagraphStyle(doc);style.Name = "style";style.CharacterFormat.FontName = "宋体";style.CharacterFormat.FontSize = 11f;doc.Styles.Add(style);for (int i = 0; i < table.Rows.Count; i++){ //设置表格行高 table.Rows[i].Height = 20f; for (int j = 0; j < table.Rows[i].Cells.Count; j++) { //设置单元格文本垂直对齐方式 table[i, j].CellFormat.VerticalAlignment = VerticalAlignment.Middle; //设置单元格的宽度，即列宽 table[i, j].Width = 200f; foreach (Paragraph para in table[i, j].Paragraphs) { //应用段落样式 para.ApplyStyle(style.Name); } }}//设置表格居中排列table.TableFormat.HorizontalAlignment = RowAlignment.Center;//保护文档，并设置模式为仅允许编辑表单域doc.Protect(ProtectionType.AllowOnlyFormFields, "123");//保存doc.SaveToFile("AddFormFields.docx", FileFormat.Docx2013);}//添加文本型窗体、复选框型窗体和下拉型窗体的方法如下：//添加文本型窗体static void AddTextFormField(Paragraph paragraph, string fieldName){ TextFormField textForm = paragraph.AppendField(fieldName, FieldType.FieldFormTextInput) as TextFormField; textForm.DefaultText = ""; textForm.Text = "";}//添加复选框型窗体static void AddCheckBoxFormField(Paragraph paragraph, string fieldName){ CheckBoxFormField checkBoxForm = paragraph.AppendField(fieldName, FieldType.FieldFormCheckBox) as CheckBoxFormField; checkBoxForm.SizeType = CheckBoxSizeType.Exactly; checkBoxForm.CheckBoxSize = 8;}//添加下拉型窗体static void AddDropDownFormField(Paragraph paragraph, string fieldName) { DropDownFormField dropDownForm = paragraph.AppendField(fieldName, FieldType.FieldFormDropDown) as DropDownFormField ; dropDownForm.DropDownItems.Add("选择一个专业"); dropDownForm.DropDownItems.Add("计算机科学与技术"); dropDownForm.DropDownItems.Add("软件工程"); dropDownForm.DropDownItems.Add("信息管理"); dropDownForm.DropDownItems.Add("电子商务");}}}

用户打开下面的生成文档，只能编辑表格中的窗体，不能修改其他内容：

添加内容控件

Word 2010及以后的版本中添加了内容控件。下面就介绍如何使用Spire.Doc添加内容控件到Word文档。

Spire.Doc支持多种内容控件类型，可在枚举SdtType中查看，如下图所示：

//创建Document实例 Document document = new Document();//添加一个sectionSection section = document.AddSection();//添加段落Paragraph paragraph = section.AddParagraph();paragraph.AppendText("姓名： ");//添加纯文本内容控件 StructureDocumentTagInline sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.Text;sdt.SDTProperties.Alias = "纯文本";//设置展示文本SdtText text = new SdtText(false);text.IsMultiline = true;sdt.SDTProperties.ControlProperties = text;TextRange rt = new TextRange(document);rt.Text = "姓名";sdt.SDTContent.ChildObjects.Add(rt);paragraph.AppendBreak(BreakType.LineBreak);//添加段落paragraph = section.AddParagraph();paragraph.AppendText("性别： ");//添加下拉列表内容控件sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.DropDownList;sdt.SDTProperties.Alias = "下拉列表";//添加下拉选项SdtDropDownList sddl = new SdtDropDownList();sddl.ListItems.Add(new SdtListItem("男", "1"));sddl.ListItems.Add(new SdtListItem("女", "2"));sdt.SDTProperties.ControlProperties = sddl;//设置控件展示的初始选项rt = new TextRange(document);rt.Text = sddl.ListItems[1].DisplayText;sdt.SDTContent.ChildObjects.Add(rt);paragraph.AppendBreak(BreakType.LineBreak);//添加段落 paragraph = section.AddParagraph();paragraph.AppendText("出生日期： ");//添加日期选取器内容控件 sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.DatePicker;sdt.SDTProperties.Alias = "日期选取器";//设置日历格式SdtDate date = new SdtDate();date.CalendarType = CalendarType.Default;date.DateFormat = "yyyy.MM.dd";date.FullDate = DateTime.Now;sdt.SDTProperties.ControlProperties = date;//设置展示日期rt = new TextRange(document);rt.Text = "1991.02.08";sdt.SDTContent.ChildObjects.Add(rt);paragraph.AppendBreak(BreakType.LineBreak);//添加段落paragraph = section.AddParagraph();paragraph.AppendText("国籍： ");//添加组合框内容控件 sdt = new StructureDocumentTagInline(document);paragraph.ChildObjects.Add(sdt);sdt.SDTProperties.SDTType = SdtType.ComboBox;sdt.SDTProperties.Alias = "组合框";//添加选项SdtComboBox cb = new SdtComboBox();cb.ListItems.Add(new SdtListItem("中国", "1"));cb.ListItems.Add(new SdtListItem("英国", "2"));cb.ListItems.Add(new SdtListItem("意大利", "3"));sdt.SDTProperties.ControlProperties = cb;//设置展示选项rt = new TextRange(document);rt.Text = cb.ListItems[0].DisplayText;sdt.SDTContent.ChildObjects.Add(rt);paragraph.AppendBreak(BreakType.LineBreak);//创建段落样式ParagraphStyle style = new ParagraphStyle(document);style.Name = "style";style.CharacterFormat.FontName = "宋?体¬?";style.CharacterFormat.FontSize = 11f;document.Styles.Add(style);//应用段落样式foreach(Paragraph para in section.Paragraphs){para.ApplyStyle(style.Name);}//保护文档，仅允许修改表单document.Protect(ProtectionType.AllowOnlyFormFields, "123");//保存 document.SaveToFile("ContentControls.docx", FileFormat.Docx2013);

生成文档：