UpdateFields

SaveOptions.UpdateFields property

Obtiene o establece un valor que determina si los campos de ciertos tipos deben actualizarse antes de guardar el documento en un formato de página fijo. El valor predeterminado para esta propiedad esverdadero .

public bool UpdateFields { get; set; }

Observaciones

Permite especificar si se imita o no el comportamiento de MS Word.

Ejemplos

Muestra cómo actualizar todos los campos de un documento inmediatamente antes de guardarlo en PDF.

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

// Insertar texto con campos PÁGINA y NUMPAGES. Estos campos no muestran el valor correcto en tiempo real.
// Necesitaremos actualizarlos manualmente usando métodos de actualización como "Field.Update()" y "Document.UpdateFields()"
// cada vez que necesitamos que muestren valores precisos.
builder.Write("Page ");
builder.InsertField("PAGE", "");
builder.Write(" of ");
builder.InsertField("NUMPAGES", "");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Hello World!");

// Crea un objeto "PdfSaveOptions" que podemos pasar al método "Guardar" del documento
// para modificar cómo ese método convierte el documento a .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Establece la propiedad "UpdateFields" en "false" para no actualizar todos los campos de un documento justo antes de guardar.
// Esta es la opción preferible si sabemos que todos nuestros campos estarán actualizados antes de guardar.
// Establece la propiedad "UpdateFields" en "true" para recorrer todo el documento
// campos y actualícelos antes de guardarlo como PDF. Esto asegurará que se muestren todos los campos.
// los valores más precisos en el PDF.
options.UpdateFields = updateFields;

// Podemos clonar objetos PdfSaveOptions.
Assert.AreNotSame(options, options.Clone());

doc.Save(ArtifactsDir + "PdfSaveOptions.UpdateFields.pdf", options);

Ver también

SaveOptions.UpdateCreatedTimeProperty SaveOptions.UpdateLastPrintedProperty