FieldOptions

FieldOptions class

表示控制文档中字段处理的选项。

要了解更多信息,请访问使用字段文档文章。

public sealed class FieldOptions

特性

姓名描述
BarcodeGenerator { get; set; }获取或设置自定义条形码生成器。
BibliographyStylesProvider { get; set; }获取或设置返回参考书目样式的提供程序FieldBibliographyFieldCitation字段.
BuiltInTemplatesPaths { get; set; }获取或设置 MS Word 内置模板的路径。
ComparisonExpressionEvaluator { get; set; }获取或设置字段比较表达式评估器。
CurrentUser { get; set; }获取或设置当前用户信息。
CustomTocStyleSeparator { get; set; }获取或设置 \t 开关的自定义样式分隔符FieldToc字段.
DefaultDocumentAuthor { get; set; }获取或设置默认文档作者的姓名。如果作者姓名已在内置文档属性中指定,则不考虑此选项。
FieldDatabaseProvider { get; set; }获取或设置返回查询结果的提供程序FieldDatabase字段.
FieldIndexFormat { get; set; }获取或设置FieldIndexFormat代表 的格式FieldIndex文档中的字段。
FieldUpdateCultureProvider { get; set; }获取或设置返回特定于每个特定字段的文化对象的提供程序。
FieldUpdateCultureSource { get; set; }指定使用什么文化来格式化字段结果。
FieldUpdatingCallback { get; set; }获取或设置IFieldUpdatingCallback实施
FieldUpdatingProgressCallback { get; set; }获取或设置IFieldUpdatingProgressCallback实施.
FileName { get; set; }获取或设置文档的文件名。
IsBidiTextSupportedOnUpdate { get; set; }获取或设置指示字段更新期间是否完全支持双向文本的值。
LegacyNumberFormat { get; set; }获取或设置指示是否启用字段的旧式(早于 AW 13.10)数字格式的值。
PreProcessCulture { get; set; }获取或设置文化以预处理字段值。
ResultFormatter { get; set; }允许控制字段结果的格式。
TemplateName { get; set; }获取或设置文档使用的模板的文件名。
ToaCategories { get; set; }获取或设置引文目录类别。
UseInvariantCultureNumberFormat { get; set; }获取或设置指示使用不变文化解析数字格式的值或不
UserPromptRespondent { get; set; }获取或设置字段更新期间对用户提示的响应者。

例子

展示如何在字段更新或邮件合并期间指定用于日期格式化的文化来源。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 插入两个具有德语语言环境的合并字段。
builder.Font.LocaleId = new CultureInfo("de-DE").LCID;
builder.InsertField("MERGEFIELD Date1 \\@ \"dddd, d MMMM yyyy\"");
builder.Write(" - ");
builder.InsertField("MERGEFIELD Date2 \\@ \"dddd, d MMMM yyyy\"");

// 在变量中保存其原始值后,将当前文化设置为美国英语。
CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");

// 此次合并将使用当前线程的文化来格式化日期,即美国英语。
doc.MailMerge.Execute(new[] { "Date1" }, new object[] { new DateTime(2020, 1, 01) });

// 配置下一次合并,从字段代码中获取其文化值。该文化值将为“德语”。
doc.FieldOptions.FieldUpdateCultureSource = FieldUpdateCultureSource.FieldCode;
doc.MailMerge.Execute(new[] { "Date2" }, new object[] { new DateTime(2020, 1, 01) });

// 第一个合并结果包含英文格式的日期,而第二个合并结果包含德文格式的日期。
Assert.AreEqual("Wednesday, 1 January 2020 - Mittwoch, 1 Januar 2020", doc.Range.Text.Trim());

// 恢复线程的原始文化。
Thread.CurrentThread.CurrentCulture = currentCulture;

也可以看看