本篇文章将介绍如何使用Spire.Doc组件在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();

'初始化document对象
Dim document As Document = New Document
'添加节
Dim section As Section = document.AddSection
'添加段落
Dim paragraph As 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);

Dim document As Document = New Document("添加变量.docx")
Dim number As Integer = 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);

'加载文档
Dim document As Document = New Document("    .docx")
'使用index检索变量的名称
Dim s1 As String = document.Variables.GetNameByIndex(0)
'使用index检索变量的值
Dim s2 As String = document.Variables.GetValueByIndex(0)
'使用变量名称检索变量的值
Dim s3 As String = document.Variables("A1")
Console.WriteLine("{0} {1} {2}", s1, s2, s3)

删除变量

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

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

//移除名称为“A1”的变量
document.Variables.Remove("A1");

//保存并关闭文档
document.SaveToFile("删除变量.docx", FileFormat.Docx2013);
document.Close();

'加载文档
Dim document As Document = New Document("    .docx")
'移除名称为“A1”的变量
document.Variables.Remove("A1")
'保存并关闭文档
document.SaveToFile(" d  .docx", FileFormat.Docx2013)
document.Close