FieldUpdateCultureSource
Contents
[
Hide
]FieldUpdateCultureSource enumeration
Indicates what culture to use during field update.
public enum FieldUpdateCultureSource
Values
| Name | Value | Description |
|---|---|---|
| CurrentThread | 0 | The culture of the current execution thread is used to update fields. |
| FieldCode | 1 | The culture specified in the field formatting properties via language setting is used. |
Examples
Shows how to specify the source of the culture used for date formatting during a field update or mail merge.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert two merge fields with German locale.
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\"");
// Set the current culture to US English after preserving its original value in a variable.
CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
// This merge will use the current thread's culture to format the date, US English.
doc.MailMerge.Execute(new[] { "Date1" }, new object[] { new DateTime(2020, 1, 01) });
// Configure the next merge to source its culture value from the field code. The value of that culture will be German.
doc.FieldOptions.FieldUpdateCultureSource = FieldUpdateCultureSource.FieldCode;
doc.MailMerge.Execute(new[] { "Date2" }, new object[] { new DateTime(2020, 1, 01) });
// The first merge result contains a date formatted in English, while the second one is in German.
Assert.AreEqual("Wednesday, 1 January 2020 - Mittwoch, 1 Januar 2020", doc.Range.Text.Trim());
// Restore the thread's original culture.
Thread.CurrentThread.CurrentCulture = currentCulture;
See Also
- namespace Aspose.Words.Fields
- assembly Aspose.Words
