OdsoRecipientData

OdsoRecipientData class

Representerar information om en enskild post inom en extern datakälla som ska uteslutas från kopplingen.

public class OdsoRecipientData

Konstruktörer

namn Beskrivning
OdsoRecipientData() Default_Constructor

Egenskaper

namn Beskrivning
Active { get; set; } Anger om posten från datakällan ska importeras till ett dokument när sammanslagningen utförs. Standardvärdet ärSann .
Column { get; set; } Anger kolumnen i datakällan som innehåller unika data för den aktuella posten. Standardvärdet är 0.
Hash { get; set; } Representerar hashkoden för denna post. Ibland använder Microsoft WordHash av en hel skiva istället för enUniqueTag value. Standardvärdet är 0.
UniqueTag { get; set; } Anger innehållet i en given post i kolumnen som innehåller unika data. Standardvärdet ärnull .

Metoder

namn Beskrivning
Clone() Returnerar en djup klon av detta objekt.

Anmärkningar

Om en post ska slås samman till en sammanfogad handling, behövs ingen information om den posten. Men om en given post inte ska slås samman till ett sammanfogat dokument, ska värdet på den unika nyckeln för den posten lagras iUniqueTag egenskapen för detta objekt för att indikera detta undantag.

Exempel

Visar hur man får åtkomst till insamlingen av data som anger vilka sammanslagningsdatakällaposter en sammanslagning kommer att utesluta.

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}");
    }
}

// Vi kan klona elementen i den här samlingen.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Vi kan också ta bort element individuellt, eller rensa hela samlingen på en gång.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Se även