FieldOptions

FieldOptions class

Représente les options permettant de contrôler la gestion des champs dans un document.

Pour en savoir plus, visitez leTravailler avec les champs article de documentation.

public sealed class FieldOptions

Propriétés

NomLa description
BarcodeGenerator { get; set; }Obtient ou définit un générateur de codes-barres personnalisé.
BibliographyStylesProvider { get; set; }Obtient ou définit un fournisseur qui renvoie un style de bibliographie pour leFieldBibliography etFieldCitation champs.
BuiltInTemplatesPaths { get; set; }Obtient ou définit les chemins des modèles intégrés de MS Word.
ComparisonExpressionEvaluator { get; set; }Obtient ou définit l’évaluateur des expressions de comparaison de champs.
CurrentUser { get; set; }Obtient ou définit les informations de l’utilisateur actuel.
CustomTocStyleSeparator { get; set; }Obtient ou définit un séparateur de style personnalisé pour le commutateur \t dansFieldToc champ.
DefaultDocumentAuthor { get; set; }Récupère ou définit le nom de l’auteur par défaut du document. Si le nom de l’auteur est déjà spécifié dans les propriétés intégrées du document, cette option n’est pas prise en compte.
FieldDatabaseProvider { get; set; }Obtient ou définit un fournisseur qui renvoie un résultat de requête pour leFieldDatabase champ.
FieldIndexFormat { get; set; }Obtient ou définit unFieldIndexFormat qui représente le formatage pour leFieldIndex champs dans le document.
FieldUpdateCultureProvider { get; set; }Obtient ou définit un fournisseur qui renvoie un objet de culture spécifique pour chaque champ particulier.
FieldUpdateCultureSource { get; set; }Spécifie la culture à utiliser pour formater le résultat du champ.
FieldUpdatingCallback { get; set; }Obtient ou définitIFieldUpdatingCallback implémentation
FieldUpdatingProgressCallback { get; set; }Obtient ou définitIFieldUpdatingProgressCallback implémentation.
FileName { get; set; }Obtient ou définit le nom de fichier du document.
IsBidiTextSupportedOnUpdate { get; set; }Obtient ou définit la valeur indiquant si le texte bidirectionnel est entièrement pris en charge lors de la mise à jour du champ ou non.
LegacyNumberFormat { get; set; }Obtient ou définit la valeur indiquant si le format numérique hérité (antérieur à AW 13.10) pour les champs est activé ou non.
PreProcessCulture { get; set; }Obtient ou définit la culture pour prétraiter les valeurs de champ.
ResultFormatter { get; set; }Permet de contrôler la façon dont le résultat du champ est formaté.
TemplateName { get; set; }Obtient ou définit le nom de fichier du modèle utilisé par le document.
ToaCategories { get; set; }Obtient ou définit le tableau des catégories d’autorités.
UseInvariantCultureNumberFormat { get; set; }Obtient ou définit la valeur indiquant que le format du nombre est analysé à l’aide d’une culture invariante ou non
UserPromptRespondent { get; set; }Obtient ou définit le répondant aux invites utilisateur lors de la mise à jour du champ.

Exemples

Montre comment spécifier la source de la culture utilisée pour le formatage de la date lors d’une mise à jour de champ ou d’un publipostage.

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

// Insérer deux champs de fusion avec les paramètres régionaux allemands.
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\"");

// Définissez la culture actuelle sur l'anglais américain après avoir conservé sa valeur d'origine dans une variable.
CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");

// Cette fusion utilisera la culture du thread actuel pour formater la date, en anglais américain.
doc.MailMerge.Execute(new[] { "Date1" }, new object[] { new DateTime(2020, 1, 01) });

// Configurez la fusion suivante pour que sa valeur de culture soit issue du code du champ. La valeur de cette culture sera allemande.
doc.FieldOptions.FieldUpdateCultureSource = FieldUpdateCultureSource.FieldCode;
doc.MailMerge.Execute(new[] { "Date2" }, new object[] { new DateTime(2020, 1, 01) });

// Le premier résultat de fusion contient une date formatée en anglais, tandis que le second est en allemand.
Assert.AreEqual("Wednesday, 1 January 2020 - Mittwoch, 1 Januar 2020", doc.Range.Text.Trim());

// Restaurer la culture d'origine du thread.
Thread.CurrentThread.CurrentCulture = currentCulture;

Voir également