OdsoRecipientData

OdsoRecipientData class

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

Um mehr zu erfahren, besuchen Sie dieSerienbriefe und Berichte Dokumentationsartikel.

public class OdsoRecipientData

Konstrukteure

NameBeschreibung
OdsoRecipientData()Default_Constructor

Eigenschaften

NameBeschreibung
Active { get; set; }Gibt an, ob der Datensatz aus der Datenquelle beim Seriendruck in ein Dokument importiert werden soll. 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 Hash-Code für diesen Datensatz dar. Manchmal verwendet Microsoft WordHash eines ganzen Datensatzes statt einesUniqueTag Wert. Der Standardwert ist 0.
UniqueTag { get; set; }Gibt den Inhalt eines bestimmten Datensatzes in der Spalte mit eindeutigen Daten an. Der Standardwert istnull .

Methoden

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

Bemerkungen

Wenn ein Datensatz in ein zusammengeführtes Dokument integriert werden soll, sind keine Informationen zu diesem Datensatz erforderlich. Wenn ein bestimmter Datensatz jedoch nicht in ein zusammengeführtes Dokument integriert werden soll, wird der Wert des eindeutigen Schlüssels für diesen Datensatz imUniqueTagEigenschaft dieses Objekts, um diesen Ausschluss anzuzeigen.

Beispiele

Zeigt, wie auf die Datensammlung zugegriffen wird, die angibt, welche Datensätze aus Seriendruckdatenquellen bei einem Seriendruck 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 Elemente auch 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