MailMergeDataField.MapToRecipientField-Methode (Publisher)
Ordnet einem Feld (Spalte) in einer bestimmten Datenquelle, dargestellt durch das übergeordnete MailMergeDataField -Objekt auf ein Empfängerfeld (einer Spalte) in der Masterdatenquelle (kombinierte Seriendruck Empfängerliste).
Syntax
Ausdruck. MapToRecipientField (bstrValue)
Ausdruck Eine Variable, die ein MailMergeDataField-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| bstrValue | Optional | String | Der Name des Empfängerfeldes, zu der die Spalte der Datenquelle zugeordnet wird. |
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.
Wenn Sie keinen Wert für den optionalen bstrValue-Parameter übergeben, geht Microsoft Publisher davon aus, dass das zuzuordnende Feld den gleichen Namen wie das Empfängerfeld in der master Datenquelle hat, der es zugeordnet ist.
Wenn Sie den Namen eines Feldes, das nicht vorhanden ist, übergeben, wird in Publisher ein Fehler zurückgegeben.
Hinweis
[!HINWEIS] Verwenden Sie zum Hinzufügen eines Feldes die AddToRecipientFields -Methode.
Beispiel
Der folgende Microsoft Visual Basic für Applikationen (VBA)-Makro zeigt, wie die MapToRecipientField -Methode, um ein Datenfeld (Spalte) in einer bestimmten Datenquelle an ein Feld in der Masterdatenquelle zuordnen (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, ersetzen fieldname Sie durch den Namen des Felds in der Datenquelle, das Sie einem Empfängerfeld zuordnen möchten, und ersetzen Sie durch recipientfieldname den Namen des Empfängerfelds.
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 Map()
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.MapToRecipientField ("recipientfieldname")
Debug.Print "Field mapped successfully."
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.