IsDirty

Field.IsDirty property

Hämtar eller ställer in om det aktuella resultatet av fältet inte längre är korrekt (inaktuellt) på grund av andra ändringar som gjorts i dokumentet.

public bool IsDirty { get; set; }

Exempel

Visar hur man använder speciella egenskaper för att uppdatera fältresultat.

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

// Ge dokumentets inbyggda egenskapsvärde "Author" och visa det sedan med ett fält.
doc.BuiltInDocumentProperties.Author = "John Doe";
FieldAuthor field = (FieldAuthor)builder.InsertField(FieldType.FieldAuthor, true);

Assert.False(field.IsDirty);
Assert.AreEqual("John Doe", field.Result);

// Uppdatera egenskapen. Fältet visar fortfarande det gamla värdet.
doc.BuiltInDocumentProperties.Author = "John & Jane Doe";

Assert.AreEqual("John Doe", field.Result);

// Eftersom fältets värde är inaktuellt kan vi markera det som "smutsigt".
// Detta värde kommer att förbli inaktuellt tills vi uppdaterar fältet manuellt med metoden Field.Update().
field.IsDirty = true;

using (MemoryStream docStream = new MemoryStream())
{
    // Om vi sparar utan att anropa en uppdateringsmetod,
    // fältet kommer att fortsätta att visa det inaktuella värdet i utdatadokumentet.
    doc.Save(docStream, SaveFormat.Docx);

    // LoadOptions-objektet har en möjlighet att uppdatera alla fält
    // markerad som "smutsig" när dokumentet laddas.
    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];

    // Uppdatering av smutsiga fält som detta sätter automatiskt deras "IsDirty"-flagga till false.
    if (updateDirtyFields)
    {
        Assert.AreEqual("John & Jane Doe", field.Result);
        Assert.False(field.IsDirty);
    }
    else
    {
        Assert.AreEqual("John Doe", field.Result);
        Assert.True(field.IsDirty);
    }
}

Se även

Field.Format Field.IsLocked