FieldMergeField
Contenu
[
Cacher
]FieldMergeField class
Implémente le champ MERGEFIELD.
Pour en savoir plus, visitez leTravailler avec les champs article de documentation.
public class FieldMergeField : Field
Propriétés
| Nom | La description |
|---|---|
| DisplayResult { get; } | Obtient le texte qui représente le résultat du champ affiché. |
| End { get; } | Obtient le nœud qui représente la fin du champ. |
| FieldName { get; set; } | Obtient ou définit le nom d’un champ de données. |
| FieldNameNoPrefix { get; } | Renvoie uniquement le nom du champ de données. Tout préfixe est supprimé et conservé dans la propriété prefix. |
| Format { get; } | Obtient unFieldFormatobjet qui fournit un accès typé au formatage du champ. |
| IsDirty { get; set; } | Obtient ou définit si le résultat actuel du champ n’est plus correct (obsolète) en raison d’autres modifications apportées au document. |
| IsLocked { get; set; } | Obtient ou définit si le champ est verrouillé (ne doit pas recalculer son résultat). |
| IsMapped { get; set; } | Obtient ou définit si ce champ est un champ mappé. |
| IsVerticalFormatting { get; set; } | Obtient ou définit s’il faut activer la conversion de caractères pour la mise en forme verticale. |
| LocaleId { get; set; } | Obtient ou définit le LCID du champ. |
| Result { get; set; } | Obtient ou définit le texte qui se trouve entre le séparateur de champ et la fin du champ. |
| Separator { get; } | Récupère le nœud représentant le séparateur de champ. Peut êtrenul . |
| Start { get; } | Obtient le nœud qui représente le début du champ. |
| TextAfter { get; set; } | Obtient ou définit le texte à insérer après le champ si le champ n’est pas vide. |
| TextBefore { get; set; } | Obtient ou définit le texte à insérer avant le champ si le champ n’est pas vide. |
| override Type { get; } | Obtient le type de champ Microsoft Word. |
Méthodes
| Nom | La description |
|---|---|
| GetFieldCode() | Renvoie le texte entre le début du champ et le séparateur de champ (ou la fin du champ s’il n’y a pas de séparateur). Le code du champ et le résultat du champ des champs enfants sont inclus. |
| GetFieldCode(bool) | Renvoie le texte entre le début du champ et le séparateur de champ (ou la fin du champ s’il n’y a pas de séparateur). |
| Remove() | Supprime le champ du document. Renvoie un nœud immédiatement après le champ. Si la fin du champ est le dernier child de son nœud parent, renvoie son paragraphe parent. Si le champ est déjà supprimé, renvoienul . |
| Unlink() | Effectue la dissociation du champ. |
| Update() | Effectue la mise à jour du champ. Lève une requête si le champ est déjà en cours de mise à jour. |
| Update(bool) | Effectue une mise à jour du champ. L’erreur est générée si le champ est déjà en cours de mise à jour. |
Remarques
Récupère le nom d’un champ de données dans les caractères de fusion d’un document principal de publipostage. Lorsque le document principal est fusionné avec la source de données sélectionnée, les informations du champ de données spécifié sont insérées à la place du champ de fusion.
Exemples
Montre comment utiliser les champs MERGEFIELD pour effectuer un publipostage.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Créez une table de données à utiliser comme source de données de publipostage.
DataTable table = new DataTable("Employees");
table.Columns.Add("Courtesy Title");
table.Columns.Add("First Name");
table.Columns.Add("Last Name");
table.Rows.Add("Mr.", "John", "Doe");
table.Rows.Add("Mrs.", "Jane", "Cardholder");
// Insérer un MERGEFIELD avec une propriété FieldName définie sur le nom d'une colonne dans la source de données.
FieldMergeField fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Courtesy Title";
fieldMergeField.IsMapped = true;
fieldMergeField.IsVerticalFormatting = false;
// Nous pouvons appliquer du texte avant et après la valeur que ce champ accepte lorsque la fusion a lieu.
fieldMergeField.TextBefore = "Dear ";
fieldMergeField.TextAfter = " ";
Assert.AreEqual(" MERGEFIELD \"Courtesy Title\" \\m \\b \"Dear \" \\f \" \"", fieldMergeField.GetFieldCode());
Assert.AreEqual(FieldType.FieldMergeField, fieldMergeField.Type);
// Insérer un autre MERGEFIELD pour une colonne différente dans la source de données.
fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Last Name";
fieldMergeField.TextAfter = ":";
doc.UpdateFields();
doc.MailMerge.Execute(table);
Assert.AreEqual("Dear Mr. Doe:\u000cDear Mrs. Cardholder:", doc.GetText().Trim());
Voir également
- class Field
- espace de noms Aspose.Words.Fields
- Assemblée Aspose.Words
