Spire.Doc系列教程（2）：插入、计数、检索和删除Word文档变量

---

插入变量

Document.Variables属性可以获取一个Variables集合（VariableCollection），该集合表示存储在文档中的变量。使用VariableCollection.Add(string name, string value) 方法，可以插入变量到文档。

以下示例添加了一个名为“A1”，值为12的变量到一个Word文档。

//初始化document对象
Document document = new Document();
//添加节
Section section = document.AddSection();
//添加段落
Paragraph paragraph = section.AddParagraph();
//添加DocVariable域
paragraph.AppendField("A1", FieldType.FieldDocVariable);
//添加文档变量到DocVariable域
document.Variables.Add("A1", "12");
//更新域
document.IsUpdateFields = true;
//保存并关闭文档
document.SaveToFile("AddVariable.docx", FileFormat.Docx2013);
document.Close();

---

计算变量个数

VariableCollection.Count属性可以计算文档中的变量个数。

//Load the document
Document document = new Document("添加变量.docx");
//Get the number of variables in the document
int number = document.Variables.Count;

Console.WriteLine(number);

---

检索变量

Spire.Doc支持使用index来检索指定变量的名称和对应的值，同时也支持直接使用变量的名称来检索或设置值。

//加载文档
Document document = new Document("添加变量.docx");

// 使用index检索变量的名称
string s1 = document.Variables.GetNameByIndex(0);

// 使用index检索变量的值
string s2 = document.Variables.GetValueByIndex(0);

// 使用变量名称检索变量的值
string s3 = document.Variables["A1"];

Console.WriteLine("{0} {1} {2}", s1, s2, s3);

---

删除变量

VariableCollection.Remove(String name) 方法可以删除文档中的指定变量，参数为该变量的名称。