OdsoRecipientData

OdsoRecipientData class

Stellt Informationen zu einem einzelnen Datensatz in einer externen Datenquelle dar, der vom Serienbrief ausgeschlossen werden soll.

Um mehr zu erfahren, besuchen Sie dieSerienbrief und Berichterstellung Dokumentationsartikel.

public class OdsoRecipientData

Konstrukteure

NameBeschreibung
OdsoRecipientData()Default_Constructor

Eigenschaften

NameBeschreibung
Active { get; set; }Gibt an, ob der Datensatz aus der Datenquelle in ein Dokument importiert werden soll, wenn der Seriendruck durchgeführt wird. Der Standardwert istWAHR .
Column { get; set; }Gibt die Spalte innerhalb der Datenquelle an, die eindeutige Daten für den aktuellen Datensatz enthält. Der Standardwert ist 0.
Hash { get; set; }Stellt den Hashcode für diesen Datensatz dar. Manchmal verwendet Microsoft WordHash eines ganzen Datensatzes statt einesUniqueTag value. Der Standardwert ist 0.
UniqueTag { get; set; }Gibt den Inhalt eines bestimmten Datensatzes in der Spalte an, die eindeutige Daten enthält. Der Standardwert istNull .

Methoden

NameBeschreibung
Clone()Gibt einen tiefen Klon dieses Objekts zurück.

Bemerkungen

Wenn ein Datensatz in einem zusammengeführten Dokument zusammengeführt werden soll, sind keine Informationen zu diesem Datensatz erforderlich. Wenn ein bestimmter Datensatz jedoch nicht in einem zusammengeführten Dokument zusammengeführt werden soll, muss der Wert des eindeutigen Schlüssels für diesen Datensatz im gespeichert werdenUniqueTagEigenschaft dieses Objekts, um diesen Ausschluss anzuzeigen.

Beispiele

Zeigt, wie auf die Datensammlung zugegriffen wird, die angibt, welche Zusammenführungsdatenquellendatensätze von einem Serienbrief ausgeschlossen werden.

Document doc = new Document(MyDir + "Odso data.docx");

OdsoRecipientDataCollection dataCollection = doc.MailMergeSettings.Odso.RecipientDatas;

Assert.AreEqual(70, dataCollection.Count);

using (IEnumerator<OdsoRecipientData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine(
            $"Odso recipient data index {index++} will {(enumerator.Current.Active ? "" : "not ")}be imported upon mail merge.");
        Console.WriteLine($"\tColumn #{enumerator.Current.Column}");
        Console.WriteLine($"\tHash code: {enumerator.Current.Hash}");
        Console.WriteLine($"\tContents array length: {enumerator.Current.UniqueTag.Length}");
    }
}

// Wir können die Elemente in dieser Sammlung klonen.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Wir können auch Elemente einzeln entfernen oder die gesamte Sammlung auf einmal löschen.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Siehe auch

OdsoFieldMappingType Enum OdsoRecipientDataCollection Class