FieldMergeField
Contenu
[
Cacher
]FieldMergeField class
Implémente le champ MERGEFIELD.
Pour en savoir plus, visitez leTravailler avec des champs article documentaire.
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é de la propriété de préfixe. |
| Format { get; } | Obtient unFieldFormat objet 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 (périmé) 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 le formatage vertical. |
| LocaleId { get; set; } | Obtient ou définit le LCID du champ. |
| Result { get; set; } | Obtient ou définit le texte situé entre le séparateur de champ et la fin du champ. |
| Separator { get; } | Obtient le nœud qui représente 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 de 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 juste 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. Lance si le champ est déjà mis à jour. |
| Update(bool) | Effectue une mise à jour du champ. Lance si le champ est déjà mis à jour. |
Remarques
Récupère le nom d’un champ de données dans les caractères de fusion dans un document principal de fusion et 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ée 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ère 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 lors de la fusion.
fieldMergeField.TextBefore = "Dear ";
fieldMergeField.TextAfter = " ";
Assert.AreEqual(" MERGEFIELD \"Courtesy Title\" \\m \\b \"Dear \" \\f \" \"", fieldMergeField.GetFieldCode());
// Insère 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
