UpdateDirtyFields
Contenido
[
Ocultar
]LoadOptions.UpdateDirtyFields property
Especifica si se deben actualizar los campos con elsucio
atributo.
public bool UpdateDirtyFields { get; set; }
Ejemplos
Muestra cómo utilizar una propiedad especial para actualizar el resultado del campo.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Proporcione el valor de propiedad "Autor" incorporado del documento y luego muéstrelo con un campo.
doc.BuiltInDocumentProperties.Author = "John Doe";
FieldAuthor field = (FieldAuthor)builder.InsertField(FieldType.FieldAuthor, true);
Assert.False(field.IsDirty);
Assert.AreEqual("John Doe", field.Result);
// Actualiza la propiedad. El campo todavía muestra el valor anterior.
doc.BuiltInDocumentProperties.Author = "John & Jane Doe";
Assert.AreEqual("John Doe", field.Result);
// Dado que el valor del campo no está actualizado, podemos marcarlo como "sucio".
// Este valor permanecerá desactualizado hasta que actualicemos el campo manualmente con el método Field.Update().
field.IsDirty = true;
using (MemoryStream docStream = new MemoryStream())
{
// Si guardamos sin llamar a un método de actualización,
// el campo seguirá mostrando el valor desactualizado en el documento de salida.
doc.Save(docStream, SaveFormat.Docx);
// El objeto LoadOptions tiene una opción para actualizar todos los campos
// marcado como "sucio" al cargar el documento.
LoadOptions options = new LoadOptions();
options.UpdateDirtyFields = updateDirtyFields;
doc = new Document(docStream, options);
Assert.AreEqual("John & Jane Doe", doc.BuiltInDocumentProperties.Author);
field = (FieldAuthor)doc.Range.Fields[0];
// La actualización de campos sucios como este establece automáticamente su indicador "IsDirty" en falso.
if (updateDirtyFields)
{
Assert.AreEqual("John & Jane Doe", field.Result);
Assert.False(field.IsDirty);
}
else
{
Assert.AreEqual("John Doe", field.Result);
Assert.True(field.IsDirty);
}
}
Ver también
- class LoadOptions
- espacio de nombres Aspose.Words.Loading
- asamblea Aspose.Words