GetFieldNamesForRegion
Contenu
[
Cacher
]GetFieldNamesForRegion(string)
Renvoie une collection de noms de champs de publipostage disponibles dans la région.
public string[] GetFieldNamesForRegion(string regionName)
| Paramètre | Taper | La description |
|---|---|---|
| regionName | String | Nom de la région (insensible à la casse). |
Remarques
Renvoie les noms de champs de fusion complets, y compris le préfixe facultatif. N’élimine pas les doublons.
Si le document contient plusieurs régions portant le même nom, la toute première région est traitée.
Un nouveau tableau de chaînes est créé à chaque appel.
Exemples
Montre comment créer, répertorier et lire les régions de publipostage.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Les balises « TableStart » et « TableEnd », qui se trouvent à l'intérieur des MERGEFIELD,
// désignent les chaînes qui signifient les débuts et les fins des régions de publipostage.
Assert.AreEqual("TableStart", doc.MailMerge.RegionStartTag);
Assert.AreEqual("TableEnd", doc.MailMerge.RegionEndTag);
// Utilisez ces balises pour démarrer et terminer une région de publipostage nommée « MailMergeRegion1 »,
// qui contiendra des MERGEFIELD pour deux colonnes.
builder.InsertField(" MERGEFIELD TableStart:MailMergeRegion1");
builder.InsertField(" MERGEFIELD Column1");
builder.Write(", ");
builder.InsertField(" MERGEFIELD Column2");
builder.InsertField(" MERGEFIELD TableEnd:MailMergeRegion1");
// Nous pouvons suivre les régions de fusion et leurs colonnes en consultant ces collections.
IList<MailMergeRegionInfo> regions = doc.MailMerge.GetRegionsByName("MailMergeRegion1");
Assert.AreEqual(1, regions.Count);
Assert.AreEqual("MailMergeRegion1", regions[0].Name);
string[] mergeFieldNames = doc.MailMerge.GetFieldNamesForRegion("MailMergeRegion1");
Assert.AreEqual("Column1", mergeFieldNames[0]);
Assert.AreEqual("Column2", mergeFieldNames[1]);
// Insérez une région avec le même nom à l'intérieur de la région existante, ce qui en fera un parent.
// Désormais, un champ « Colonne 2 » sera à l'intérieur d'une nouvelle région.
builder.MoveToField(regions[0].Fields[1], false);
builder.InsertField(" MERGEFIELD TableStart:MailMergeRegion1");
builder.MoveToField(regions[0].Fields[1], true);
builder.InsertField(" MERGEFIELD TableEnd:MailMergeRegion1");
// Si nous recherchons le nom des régions en double à l'aide de la méthode « GetRegionsByName »,
// il renverra toutes ces régions dans une collection.
regions = doc.MailMerge.GetRegionsByName("MailMergeRegion1");
Assert.AreEqual(2, regions.Count);
// Vérifiez que la deuxième région a désormais une région parent.
Assert.AreEqual("MailMergeRegion1", regions[1].ParentRegion.Name);
mergeFieldNames = doc.MailMerge.GetFieldNamesForRegion("MailMergeRegion1", 1);
Assert.AreEqual("Column2", mergeFieldNames[0]);
Voir également
- class MailMerge
- espace de noms Aspose.Words.MailMerging
- Assemblée Aspose.Words
GetFieldNamesForRegion(string, int)
Renvoie une collection de noms de champs de publipostage disponibles dans la région.
public string[] GetFieldNamesForRegion(string regionName, int regionIndex)
| Paramètre | Taper | La description |
|---|---|---|
| regionName | String | Nom de la région (insensible à la casse). |
| regionIndex | Int32 | Indice de région (à partir de zéro). |
Remarques
Renvoie les noms de champs de fusion complets, y compris le préfixe facultatif. N’élimine pas les doublons.
Si le document contient plusieurs régions portant le même nom, la N-ième région (à partir de zéro) est traitée.
Un nouveau tableau de chaînes est créé à chaque appel.
Exemples
Montre comment créer, répertorier et lire les régions de publipostage.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Les balises « TableStart » et « TableEnd », qui se trouvent à l'intérieur des MERGEFIELD,
// désignent les chaînes qui signifient les débuts et les fins des régions de publipostage.
Assert.AreEqual("TableStart", doc.MailMerge.RegionStartTag);
Assert.AreEqual("TableEnd", doc.MailMerge.RegionEndTag);
// Utilisez ces balises pour démarrer et terminer une région de publipostage nommée « MailMergeRegion1 »,
// qui contiendra des MERGEFIELD pour deux colonnes.
builder.InsertField(" MERGEFIELD TableStart:MailMergeRegion1");
builder.InsertField(" MERGEFIELD Column1");
builder.Write(", ");
builder.InsertField(" MERGEFIELD Column2");
builder.InsertField(" MERGEFIELD TableEnd:MailMergeRegion1");
// Nous pouvons suivre les régions de fusion et leurs colonnes en consultant ces collections.
IList<MailMergeRegionInfo> regions = doc.MailMerge.GetRegionsByName("MailMergeRegion1");
Assert.AreEqual(1, regions.Count);
Assert.AreEqual("MailMergeRegion1", regions[0].Name);
string[] mergeFieldNames = doc.MailMerge.GetFieldNamesForRegion("MailMergeRegion1");
Assert.AreEqual("Column1", mergeFieldNames[0]);
Assert.AreEqual("Column2", mergeFieldNames[1]);
// Insérez une région avec le même nom à l'intérieur de la région existante, ce qui en fera un parent.
// Désormais, un champ « Colonne 2 » sera à l'intérieur d'une nouvelle région.
builder.MoveToField(regions[0].Fields[1], false);
builder.InsertField(" MERGEFIELD TableStart:MailMergeRegion1");
builder.MoveToField(regions[0].Fields[1], true);
builder.InsertField(" MERGEFIELD TableEnd:MailMergeRegion1");
// Si nous recherchons le nom des régions en double à l'aide de la méthode « GetRegionsByName »,
// il renverra toutes ces régions dans une collection.
regions = doc.MailMerge.GetRegionsByName("MailMergeRegion1");
Assert.AreEqual(2, regions.Count);
// Vérifiez que la deuxième région a désormais une région parent.
Assert.AreEqual("MailMergeRegion1", regions[1].ParentRegion.Name);
mergeFieldNames = doc.MailMerge.GetFieldNamesForRegion("MailMergeRegion1", 1);
Assert.AreEqual("Column2", mergeFieldNames[0]);
Voir également
- class MailMerge
- espace de noms Aspose.Words.MailMerging
- Assemblée Aspose.Words
