UpdateFields

Range.UpdateFields method

Aggiorna i valori dei campi del documento in questo intervallo.

public void UpdateFields()

Osservazioni

Quando apri, modifichi e quindi salvi un documento, Aspose.Words non aggiorna automaticamente i campi, li mantiene intatti. Pertanto, di solito vorresti chiamare questo metodo prima di salvare se hai modificato document a livello di codice e vuoi assicurarti i valori dei campi corretti (calcolati) vengono visualizzati nel documento salvato.

Non è necessario aggiornare i campi dopo aver eseguito una stampa unione perché la stampa unione è una sorta di campo update e aggiorna automaticamente tutti i campi nel documento.

Questo metodo non aggiorna tutti i tipi di campo. Per l’elenco dettagliato dei tipi di campo supportati, vedere la Guida per il programmatore.

Questo metodo non aggiorna i campi correlati agli algoritmi di layout della pagina (ad esempio PAGE, PAGES, PAGEREF). I campi relativi al layout della pagina vengono aggiornati quando si esegue il rendering di un documento o si chiamaUpdatePageLayout.

Per aggiornare i campi nell’intero documento utilizzareUpdateFields.

Esempi

Mostra come aggiornare tutti i campi in un intervallo.

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

builder.InsertField(" DOCPROPERTY Category");
builder.InsertBreak(BreakType.SectionBreakEvenPage);
builder.InsertField(" DOCPROPERTY Category");

// I campi DOCPROPERTY precedenti visualizzeranno il valore di questa proprietà del documento incorporata.
doc.BuiltInDocumentProperties.Category = "MyCategory";

// Se aggiorniamo il valore di una proprietà del documento, dovremo aggiornare tutti i campi DOCPROPERTY per visualizzarlo.
Assert.AreEqual(string.Empty, doc.Range.Fields[0].Result);
Assert.AreEqual(string.Empty, doc.Range.Fields[1].Result);

// Aggiorna tutti i campi compresi nell'intervallo della prima sezione.
doc.FirstSection.Range.UpdateFields();

Assert.AreEqual("MyCategory", doc.Range.Fields[0].Result);
Assert.AreEqual(string.Empty, doc.Range.Fields[1].Result);

Guarda anche

Range.UnlinkFields