FieldMergeRec
Contenuti
[
Nascondere
]FieldMergeRec class
Implementa il campo MERGEREC.
Per saperne di più, visita ilLavorare con i campi articolo di documentazione.
public class FieldMergeRec : Field
Costruttori
Nome | Descrizione |
---|---|
FieldMergeRec() | Default_Costruttore |
Proprietà
Nome | Descrizione |
---|---|
DisplayResult { get; } | Ottiene il testo che rappresenta il risultato del campo visualizzato. |
End { get; } | Ottiene il nodo che rappresenta la fine del campo. |
Format { get; } | Ottiene aFieldFormat oggetto che fornisce accesso digitato alla formattazione del campo. |
IsDirty { get; set; } | Ottiene o imposta se il risultato corrente del campo non è più corretto (obsoleto) a causa di altre modifiche apportate al documento. |
IsLocked { get; set; } | Ottiene o imposta se il campo è bloccato (non deve ricalcolare il risultato). |
LocaleId { get; set; } | Ottiene o imposta l’LCID del campo. |
Result { get; set; } | Ottiene o imposta il testo compreso tra il separatore di campo e la fine del campo. |
Separator { get; } | Ottiene il nodo che rappresenta il separatore di campo. Può esserenullo . |
Start { get; } | Ottiene il nodo che rappresenta l’inizio del campo. |
virtual Type { get; } | Ottiene il tipo di campo Microsoft Word. |
Metodi
Nome | Descrizione |
---|---|
GetFieldCode() | Restituisce il testo compreso tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi secondari. |
GetFieldCode(bool) | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore). |
Remove() | Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo figlio del suo nodo genitore, restituisce il paragrafo genitore. Se il campo è già stato rimosso, restituiscenullo . |
Unlink() | Esegue lo scollegamento del campo. |
Update() | Esegue l’aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento. |
Update(bool) | Esegue un aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento. |
Osservazioni
Al momento i campi MERGEREC e MERGESEQ implementano la stessa funzionalità perché non sappiamo con certezza come saltare i record nella stampa unione di Aspose.Words.
Esempi
Mostra come utilizzare i campi MERGEREC e MERGESEQ per il numero e il conteggio dei record di stampa unione nei documenti di output di una stampa unione.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Dear ");
FieldMergeField fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Name";
builder.Writeln(",");
// Un campo MERGEREC stamperà il numero di riga dei dati da unire in ogni documento di output dell'unione.
builder.Write("\nRow number of record in data source: ");
FieldMergeRec fieldMergeRec = (FieldMergeRec)builder.InsertField(FieldType.FieldMergeRec, true);
Assert.AreEqual(" MERGEREC ", fieldMergeRec.GetFieldCode());
// Un campo MERGESEQ conterà il numero di unioni riuscite e stamperà il valore corrente su ciascuna rispettiva pagina.
// Se una stampa unione non salta alcuna riga e non richiama alcun campo SKIP/SKIPIF/NEXT/NEXTIF, tutte le unioni hanno esito positivo.
// I campi MERGESEQ e MERGEREC visualizzeranno gli stessi risultati della stampa unione riuscita.
builder.Write("\nSuccessful merge number: ");
FieldMergeSeq fieldMergeSeq = (FieldMergeSeq)builder.InsertField(FieldType.FieldMergeSeq, true);
Assert.AreEqual(" MERGESEQ ", fieldMergeSeq.GetFieldCode());
// Inserisci un campo SKIPIF, che salterà un'unione se il nome è "John Doe".
FieldSkipIf fieldSkipIf = (FieldSkipIf)builder.InsertField(FieldType.FieldSkipIf, true);
builder.MoveTo(fieldSkipIf.Separator);
fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Name";
fieldSkipIf.LeftExpression = "=";
fieldSkipIf.RightExpression = "John Doe";
// Crea un'origine dati con 3 righe, una delle quali ha "John Doe" come valore per la colonna "Nome".
// Poiché un campo SKIPIF verrà attivato una volta da quel valore, l'output della nostra stampa unione avrà 2 pagine invece di 3.
// Nella pagina 1, i campi MERGESEQ e MERGEREC visualizzeranno entrambi "1".
// A pagina 2, il campo MERGEREC visualizzerà "3" e il campo MERGESEQ visualizzerà "2".
DataTable table = new DataTable("Employees");
table.Columns.Add("Name");
table.Rows.Add(new[] { "Jane Doe" });
table.Rows.Add(new[] { "John Doe" });
table.Rows.Add(new[] { "Joe Bloggs" });
doc.MailMerge.Execute(table);
doc.Save(ArtifactsDir + "Field.MERGEREC.MERGESEQ.docx");
Guarda anche
- class Field
- spazio dei nomi Aspose.Words.Fields
- assemblea Aspose.Words