MailMergeSettings

MailMergeSettings class

Specifica tutte le informazioni sulla stampa unione per un documento.

Per saperne di più, visita ilStampa unione e reporting articolo di documentazione.

public class MailMergeSettings

Costruttori

Nome	Descrizione
MailMergeSettings()	Default_Costruttore

Proprietà

Nome	Descrizione
ActiveRecord { get; set; }	Specifica l’indice in base uno del record dall’origine dati che verrà visualizzato in Microsoft Word. Il valore predefinito è 1.
AddressFieldName { get; set; }	Specifica la colonna all’interno dell’origine dati che contiene gli indirizzi di posta elettronica. Il valore predefinito è una stringa vuota.
CheckErrors { get; set; }	Specifica il tipo di segnalazione degli errori che verrà condotta da Microsoft Word durante l’esecuzione di una stampa unione. Il valore predefinito èDefault .
ConnectString { get; set; }	Specifica la stringa di connessione utilizzata per connettersi a un’origine dati esterna. Il valore predefinito è una stringa vuota.
DataSource { get; set; }	Specifica il percorso dell’origine dati di stampa unione. Il valore predefinito è una stringa vuota.
DataType { get; set; }	Specifica il tipo di origine dati di stampa unione e il metodo di accesso ai dati. Il valore predefinito èDefault .
Destination { get; set; }	Specifica il modo in cui Microsoft Word restituirà i risultati di una stampa unione. Il valore predefinito èDefault .
DoNotSupressBlankLines { get; set; }	Specifica il modo in cui un’applicazione che esegue la stampa unione dovrà gestire le righe vuote nei documenti uniti risultanti dalla stampa unione. Il valore predefinito è`falso` .
HeaderSource { get; set; }	Specifica il percorso dell’origine dell’intestazione della stampa unione. Il valore predefinito è una stringa vuota.
LinkToQuery { get; set; }	Non sono sicuro di questo. Il riferimento all’automazione di Microsoft Word suggerisce che questo specifichi che la query viene eseguita ogni volta che il documento viene aperto in Microsoft Word. Ma la specifica OOXML suggerisce che ciò specifichi che la query contiene un riferimento a un file di query esterno che contiene la query effettiva. Il valore predefinito è`falso` .
MailAsAttachment { get; set; }	Specifica che i documenti prodotti durante un’operazione di stampa unione devono essere inviati tramite posta elettronica come allegato anziché anziché come corpo del messaggio di posta elettronica vero e proprio. Il valore predefinito è`falso` .
MailSubject { get; set; }	Specifica il testo che dovrà apparire nella riga dell’oggetto delle e-mail o dei fax prodotti durante la stampa in serie. Il valore predefinito è una stringa vuota.
MainDocumentType { get; set; }	Specifica il tipo di documento principale di stampa unione. Il valore predefinito èDefault .
Odso { get; set; }	Ottiene o imposta l’oggetto che specifica le impostazioni ODSO (Office Data Source Object).
Query { get; set; }	Contiene la stringa Structured Query Language che verrà eseguita sull’origine dati esterna specificata per restituire il set di record che verrà importato nel documento quando viene eseguita l’operazione di stampa unione. Il valore predefinito è una stringa vuota.
ViewMergedData { get; set; }	Specifica che Microsoft Word visualizzerà i dati dall’origine dati esterna specificata in cui sono stati inseriti i campi unione (ad esempio anteprima dei dati uniti). Il valore predefinito è`falso` .

Metodi

Nome	Descrizione
Clear()	Cancella le impostazioni di stampa unione in modo tale che quando il documento viene salvato, nessuna impostazione di stampa unione verrà salvata e diventerà un documento normale.
Clone()	Restituisce un clone profondo di questo oggetto.

Osservazioni

È possibile utilizzare questo oggetto per specificare un’origine dati di stampa unione per un documento e queste informazioni (insieme ai campi dati disponibili) verranno visualizzate in Microsoft Word quando l’utente apre questo documento. Oppure è possibile utilizzare questo oggetto per eseguire query sulle impostazioni di stampa unione che l’utente ha specificato in Microsoft Word per questo documento.

Normalmente non è necessario creare direttamente gli oggetti di questa classe perché le impostazioni di stampa unione di un documento sono sempre disponibili tramiteMailMergeSettings proprietà.

Per rilevare se questo documento è un documento principale di stampa unione, controlla il valore di MainDocumentType proprietà.

Per rimuovere le impostazioni della stampa unione e le informazioni sull’origine dati da un documento puoi utilizzare Clear metodo. Aspose.Words non scriverà le impostazioni di stampa unione su un documento se ilMainDocumentType la proprietà è impostata suNotAMergeDocument o ilDataType la proprietà è impostata suNone.

Il modo migliore per imparare come utilizzare le proprietà di questo oggetto è creare manualmente un documento con l’origine dati desiderata in Microsoft Word, quindi aprire quel documento utilizzando Aspose.Words ed esaminare le proprietà dell’oggettoMailMergeSettings EOdso oggetti. Questo è un buon approccio da adottare se vuoi imparare come configurare a livello di codice un’origine dati, ad esempio.

Aspose.Words conserva le informazioni sulla stampa unione durante il caricamento, il salvataggio e la conversione di documenti tra diversi formati, ma non utilizza queste informazioni quando esegue la propria stampa unione utilizzando il comandoMailMerge oggetto.

Esempi

Mostra come eseguire una stampa unione con i dati di un oggetto origine dati di Office.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Dear ");
builder.InsertField("MERGEFIELD FirstName", "<FirstName>");
builder.Write(" ");
builder.InsertField("MERGEFIELD LastName", "<LastName>");
builder.Writeln(": ");
builder.InsertField("MERGEFIELD Message", "<Message>");

// Crea un'origine dati sotto forma di file ASCII, con "|" carattere
// funge da delimitatore che separa le colonne. La prima riga contiene i nomi delle tre colonne,
// e ogni riga successiva è una riga con i rispettivi valori.
string[] lines = { "FirstName|LastName|Message",
    "John|Doe|Hello! This message was created with Aspose Words mail merge." };
string dataSrcFilename = ArtifactsDir + "MailMerge.MailMergeSettings.DataSource.txt";

File.WriteAllLines(dataSrcFilename, lines);

MailMergeSettings settings = doc.MailMergeSettings;
settings.MainDocumentType = MailMergeMainDocumentType.MailingLabels;
settings.CheckErrors = MailMergeCheckErrors.Simulate;
settings.DataType = MailMergeDataType.Native;
settings.DataSource = dataSrcFilename;
settings.Query = "SELECT * FROM " + doc.MailMergeSettings.DataSource;
settings.LinkToQuery = true;
settings.ViewMergedData = true;

Assert.AreEqual(MailMergeDestination.Default, settings.Destination);
Assert.False(settings.DoNotSupressBlankLines);

Odso odso = settings.Odso;
odso.DataSource = dataSrcFilename;
odso.DataSourceType = OdsoDataSourceType.Text;
odso.ColumnDelimiter = '|';
odso.FirstRowContainsColumnNames = true;

Assert.AreNotSame(odso, odso.Clone());
Assert.AreNotSame(settings, settings.Clone());

 // L'apertura di questo documento in Microsoft Word eseguirà la stampa unione prima di visualizzarne il contenuto.
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

Guarda anche

spazio dei nomi Aspose.Words.Settings
assemblea Aspose.Words

MailMergeMainDocumentType Enum MsWordVersion Enum