MailMergeDataField.AddToRecipientFields-Methode (Publisher)

Die Masterdatenquelle (Auflistung von Datenfeldern) für eine Seriendruckpublikation hinzugefügt das übergeordnete MailMergeDataField -Objekt aus einer bestimmten Datenquelle.

Syntax

Ausdruck. AddToRecipientFields

Ausdruck Eine Variable, die ein MailMergeDataField-Objekt darstellt.

Hinweise

Diese Methode funktioniert nur, wenn das übergeordnete MailMergeDataField -Objekt nicht bereits auf ein Empfängerfeld zugeordnet wurde. Verwenden Sie die IsMapped-Eigenschaft , um zu ermitteln, ob das Objekt bereits zugeordnet wurde.

Beispiel

Der folgende Microsoft Visual Basic für Applikationen (VBA)-Makro zeigt, wie die AddToRecipientFields -Methode so Masterdatenquelle ein Datenfeld (Spalte) in einer bestimmten Datenquelle hinzu (kombinierter Empfängerliste) für die Publikation.

Ersetzen datasourceindex Sie vor dem Ausführen dieses Makros durch die Indexnummer einer gültigen Datenquelle in der Datenquellenauflistung des aktiven Dokuments, und ersetzen Sie durch fieldname den Namen des Felds in der Datenquelle, das Sie der kombinierten Liste der Empfängerfelder hinzufügen möchten.

Hinweis

Ein Beispiel dafür, wie Sie die Name-Eigenschaft des DataSource-Objekts verwenden können, um die Indexnummer der gewünschten Datenquelle zu bestimmen, finden Sie unter der MailMergeDataSources.Item-Methode .

Public Sub AddToRecipientFields_Example() 
 
 Dim pubMailMergeDataSources As Publisher.MailMergeDataSources 
 Dim pubMailMergeDataField As Publisher.MailMergeDataField 
 
 Set pubMailMergeDataSources = ThisDocument.MailMerge.DataSource.DataSources 
 Set pubMailMergeDataField = pubMailMergeDataSources.Item(datasourceindex).DataFields.Item("fieldname") 
 
 If pubMailMergeDataField.IsMapped Then 
 
 Debug.Print "This field is already mapped!" 
 
 Else 
 
 pubMailMergeDataField.AddToRecipientFields 
 Debug.Print "Field added successfully. (You can verify this by looking at the recipient or product list in the UI.)" 
 
 End If 
 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.