Atualizar Campos

Normalmente, um campo inserido em Microsoft Word já contém um valor atualizado. Por exemplo, se o campo for uma fórmula ou um número de página, conterá o valor calculado correcto para a versão dada do documento. Mas se você tiver um aplicativo que gera ou modifica um documento com campos como mesclar dois documentos ou preenchê-lo com dados, então, idealmente, todos os campos devem ser atualizados para que o documento seja útil.

Como atualizar campos

Quando um documento é carregado, Aspose.Words imita o comportamento de Microsoft Word com a opção de atualizar automaticamente os campos desativada. O comportamento pode ser resumido da seguinte forma:

• quando abre / guarda um documento, os campos permanecem intactos
• é possível atualizar explicitamente todos os campos de um documento, por exemplo, reconstruir TOC quando for necessário
• quando você imprime / renderiza em PDF ou XPS, os campos relacionados à numeração de páginas nos cabeçalhos/rodapés são atualizados
• quando você executa Mail Merge todos os campos são atualizados automaticamente

Atualizar Campos Programaticamente

Para atualizar explicitamente os campos em todo o documento, basta chamar o método UpdateFields. Para atualizar os campos contidos em parte de um documento, obtenha um objeto Range e chame o método UpdateFields. Em Aspose.Words, Você pode obter um Range para qualquer nó na árvore de documentos, como Section, HeaderFooter, Paragraph, etc. usando a propriedade GetRange. Você pode atualizar o resultado de um único campo chamando o método Update.

Atualização automática dos campos relacionados com a Página durante a renderização

Quando você executa a conversão de um documento para um formato de página fixa, por exemplo, para PDF ou XPS, então Aspose.Words atualizará automaticamente os campos relacionados ao layout da Página PAGE, PAGEREF encontrados nos cabeçalhos/rodapés do documento. Este comportamento imita o comportamento de Microsoft Word ao imprimir um documento.

Se você quiser atualizar todos os outros campos no documento, então você precisa chamar UpdateFields antes de renderizar o documento.

O exemplo a seguir mostra como atualizar todos os campos Antes de renderizar um documento:

Actualização automática do campo durante Mail Merge

Ao executar um mail merge, todos os campos do documento serão atualizados automaticamente. Isso ocorre porque o Mail Merge é um caso de uma atualização de campo. O programa encontra um campo Mail Merge e precisa atualizar seu resultado, o que envolve pegar o valor da fonte de dados e inseri-lo no campo. A lógica é, naturalmente, mais complicada, por exemplo, quando se chega ao final da região do documento/mail merge, mas ainda há mais dados a fundir, então a região tem de ser duplicada e o novo conjunto de campos actualizado.

Atualizar campos com atributo Sujo

O w: dirty é um atributo de nível de campo que atualizará apenas o campo especificado quando o documento for aberto. Diz ao MS Word para actualizar este campo apenas na próxima vez que o documento for aberto. Você pode usar LoadOptions.setUpdateDirtyFields () propriedade para especificar se deseja atualizar os campos com o atributo dirty. Quando o valor de LoadOptions.setUpdateDirtyFields () é definido como true, todos os campos com valor true para a propriedade Field.IsDirty ou FieldChar.IsDirty são atualizados no carregamento do documento.

O exemplo de código a seguir mostra como atualizar campos com o atributo dirty:

Atualizar LastSavedTime Propriedade Antes De Salvar

Você pode usar a propriedade UpdateLastSavedTimeProperty se deseja atualizar a propriedade de Documento interna correspondente LastSavedTime ao salvar o documento.

O exemplo de código a seguir mostra como atualizar essa propriedade: