FieldSkipIf
Contenuti
[
Nascondere
]FieldSkipIf class
Implementa il campo SKIPIF.
Per saperne di più, visita ilLavorare con i campi articolo di documentazione.
public class FieldSkipIf : Field
Costruttori
| Nome | Descrizione |
|---|---|
| FieldSkipIf() | Default_Costruttore |
Proprietà
| Nome | Descrizione |
|---|---|
| ComparisonOperator { get; set; } | Ottiene o imposta l’operatore di confronto. |
| 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 unFieldFormatoggetto che fornisce accesso tipizzato 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 dovrebbe ricalcolare il suo risultato). |
| LeftExpression { get; set; } | Ottiene o imposta la parte sinistra dell’espressione di confronto. |
| 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. |
| RightExpression { get; set; } | Ottiene o imposta la parte corretta dell’espressione di confronto. |
| Separator { get; } | Ottiene il nodo che rappresenta il separatore di campo. Può esserenull . |
| Start { get; } | Ottiene il nodo che rappresenta l’inizio del campo. |
| virtual Type { get; } | Ottiene il tipo di campo di Microsoft Word. |
Metodi
| Nome | Descrizione |
|---|---|
| GetFieldCode() | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è un separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi figlio. |
| GetFieldCode(bool) | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è separatore). |
| Remove() | Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo nodo figlio del suo nodo padre, restituisce il paragrafo padre. Se il campo è già stato rimosso, restituiscenull . |
| Unlink() | Esegue lo scollegamento del campo. |
| Update() | Esegue l’aggiornamento del campo. Genera un’eccezione se il campo è già in fase di aggiornamento. |
| Update(bool) | Esegue un aggiornamento di campo. Genera un’eccezione se il campo è già in fase di aggiornamento. |
Osservazioni
Confronta i valori designati dalle espressioniLeftExpression ERightExpression in confronto utilizzando l’operatore designato daComparisonOperator Se il confronto è vero, SKIPIF annulla il documento di unione corrente, passa al record di dati successivo nell’origine dati e avvia un nuovo documento di unione. Se il confronto è falso, il documento di unione corrente continua.
Esempi
Mostra come saltare le pagine in una stampa unione utilizzando il campo SKIPIF.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserisce un campo SKIPIF. Se la riga corrente di un'operazione di stampa unione soddisfa la condizione
// se le espressioni di questo campo indicano, l'operazione di unione di posta interrompe la riga corrente,
// scarta il documento di unione corrente e passa immediatamente alla riga successiva per iniziare il documento di unione successivo.
FieldSkipIf fieldSkipIf = (FieldSkipIf) builder.InsertField(FieldType.FieldSkipIf, true);
// Spostiamo il builder sul separatore del campo SKIPIF in modo da poter posizionare un MERGEFIELD all'interno del campo SKIPIF.
builder.MoveTo(fieldSkipIf.Separator);
FieldMergeField fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Department";
// Il MERGEFIELD si riferisce alla colonna "Dipartimento" nella nostra tabella dati. Se una riga di quella tabella
// ha un valore di "HR" nella sua colonna "Department", allora questa riga soddisferà la condizione.
fieldSkipIf.LeftExpression = "=";
fieldSkipIf.RightExpression = "HR";
// Aggiungiamo contenuto al nostro documento, creiamo l'origine dati ed eseguiamo la stampa unione.
builder.MoveToDocumentEnd();
builder.Write("Dear ");
fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Name";
builder.Writeln(", ");
// Questa tabella ha tre righe e una di queste soddisfa la condizione del nostro campo SKIPIF.
// La stampa unione produrrà due pagine.
DataTable table = new DataTable("Employees");
table.Columns.Add("Name");
table.Columns.Add("Department");
table.Rows.Add("John Doe", "Sales");
table.Rows.Add("Jane Doe", "Accounting");
table.Rows.Add("John Cardholder", "HR");
doc.MailMerge.Execute(table);
doc.Save(ArtifactsDir + "Field.SKIPIF.docx");
Mostra come utilizzare i campi MERGEREC e MERGESEQ per numerare e contare i 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 ogni pagina corrispondente.
// Se una stampa unione non salta alcuna riga e non richiama alcun campo SKIP/SKIPIF/NEXT/NEXTIF, tutte le unioni avranno esito positivo.
// I campi MERGESEQ e MERGEREC visualizzeranno gli stessi risultati se la loro unione dati ha avuto esito positivo.
builder.Write("\nSuccessful merge number: ");
FieldMergeSeq fieldMergeSeq = (FieldMergeSeq)builder.InsertField(FieldType.FieldMergeSeq, true);
Assert.AreEqual(" MERGESEQ ", fieldMergeSeq.GetFieldCode());
// Inserire un campo SKIPIF, che salterà l'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 con "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 anziché 3.
// A 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("Jane Doe");
table.Rows.Add("John Doe");
table.Rows.Add("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
