StopTrackRevisions

Document.StopTrackRevisions method

Stops automatic marking of document changes as revisions.

public void StopTrackRevisions()

Examples

Shows how to track revisions while editing a document.

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

// Editing a document usually does not count as a revision until we begin tracking them.
builder.Write("Hello world! ");

Assert.That(doc.Revisions.Count, Is.EqualTo(0));
Assert.That(doc.FirstSection.Body.Paragraphs[0].Runs[0].IsInsertRevision, Is.False);

doc.StartTrackRevisions("John Doe");

builder.Write("Hello again! ");

Assert.That(doc.Revisions.Count, Is.EqualTo(1));
Assert.That(doc.FirstSection.Body.Paragraphs[0].Runs[1].IsInsertRevision, Is.True);
Assert.That(doc.Revisions[0].Author, Is.EqualTo("John Doe"));
Assert.That((DateTime.Now - doc.Revisions[0].DateTime).Milliseconds <= 10, Is.True);

// Stop tracking revisions to not count any future edits as revisions.
doc.StopTrackRevisions();
builder.Write("Hello again! ");

Assert.That(doc.Revisions.Count, Is.EqualTo(1));
Assert.That(doc.FirstSection.Body.Paragraphs[0].Runs[2].IsInsertRevision, Is.False);

// Creating revisions gives them a date and time of the operation.
// We can disable this by passing DateTime.MinValue when we start tracking revisions.
doc.StartTrackRevisions("John Doe", DateTime.MinValue);
builder.Write("Hello again! ");

Assert.That(doc.Revisions.Count, Is.EqualTo(2));
Assert.That(doc.Revisions[1].Author, Is.EqualTo("John Doe"));
Assert.That(doc.Revisions[1].DateTime, Is.EqualTo(DateTime.MinValue));

// We can accept/reject these revisions programmatically
// by calling methods such as Document.AcceptAllRevisions, or each revision's Accept method.
// In Microsoft Word, we can process them manually via "Review" -> "Changes".
doc.Save(ArtifactsDir + "Revision.StartTrackRevisions.docx");

See Also

Document.StartTrackRevisions Document.UnlinkFields