Revision

Revision class

表示文档节点或样式中的修订(跟踪更改)。 使用RevisionType检查此版本的类型。

public class Revision

特性

姓名 描述
Author { get; set; } 获取或设置此修订的作者。不能为空字符串或 null.
DateTime { get; set; } 获取或设置此修订的日期/时间。
Group { get; } 获取修订组。如果修订不属于任何组,则返回 null。
ParentNode { get; } 获取此修订的直接父节点(所有者)。 此属性适用于除此之外的任何修订类型StyleDefinitionChange.
ParentStyle { get; } 获取此修订的直接父样式(所有者)。 此属性仅适用于StyleDefinitionChange修订类型.
RevisionType { get; } 获取此修订的类型。

方法

姓名 描述
Accept() 接受此修订。
Reject() 拒绝此修订。

例子

显示如何使用文档中的修订。

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

// 文档的正常编辑不算作修订。
builder.Write("This does not count as a revision. ");

Assert.IsFalse(doc.HasRevisions);

// 要将我们的编辑注册为修订,我们需要声明作者,然后开始跟踪它们。
doc.StartTrackRevisions("John Doe", DateTime.Now);

builder.Write("This is revision #1. ");

Assert.IsTrue(doc.HasRevisions);
Assert.AreEqual(1, doc.Revisions.Count);

// 此标志对应于“评论”-> “跟踪”-> Microsoft Word 中的“跟踪更改”选项。
// “StartTrackRevisions”方法不影响它的值,
// 并且文档以编程方式跟踪修订,尽管它的值为“false”。
// 如果我们使用 Microsoft Word 打开此文档,它将不会跟踪修订。
Assert.IsFalse(doc.TrackRevisions);

// 我们使用文档构建器添加了文本,因此第一个修订版是插入类型的修订版。
Revision revision = doc.Revisions[0];
Assert.AreEqual("John Doe", revision.Author);
Assert.AreEqual("This is revision #1. ", revision.ParentNode.GetText());
Assert.AreEqual(RevisionType.Insertion, revision.RevisionType);
Assert.AreEqual(revision.DateTime.Date, DateTime.Now.Date);
Assert.AreEqual(doc.Revisions.Groups[0], revision.Group);

// 删除运行以创建删除类型的修订。
doc.FirstSection.Body.FirstParagraph.Runs[0].Remove();

// 添加新的修订版将其放置在修订版集合的开头。
Assert.AreEqual(RevisionType.Deletion, doc.Revisions[0].RevisionType);
Assert.AreEqual(2, doc.Revisions.Count);

// 即使在我们接受/拒绝修订之前,插入修订也会显示在文档正文中。
// 拒绝修订将从正文中删除其节点。相反,构成删除修订的节点
// 也会在文档中逗留,直到我们接受修订。
Assert.AreEqual("This does not count as a revision. This is revision #1.", doc.GetText().Trim());

// 接受删除修订将从段落文本中删除其父节点
// 然后删除集合的修订本身。
doc.Revisions[0].Accept();

Assert.AreEqual(1, doc.Revisions.Count);
Assert.AreEqual("This is revision #1.", doc.GetText().Trim());

builder.Writeln("");
builder.Write("This is revision #2.");

// 现在移动节点以创建移动修订类型。
Node node = doc.FirstSection.Body.Paragraphs[1];
Node endNode = doc.FirstSection.Body.Paragraphs[1].NextSibling;
Node referenceNode = doc.FirstSection.Body.Paragraphs[0];

while (node != endNode)
{
    Node nextNode = node.NextSibling;
    doc.FirstSection.Body.InsertBefore(node, referenceNode);
    node = nextNode;
}

Assert.AreEqual(RevisionType.Moving, doc.Revisions[0].RevisionType);
Assert.AreEqual(8, doc.Revisions.Count);
Assert.AreEqual("This is revision #2.\rThis is revision #1. \rThis is revision #2.", doc.GetText().Trim());

// 移动修订现在位于索引 1。拒绝修订以丢弃其内容。
doc.Revisions[1].Reject();

Assert.AreEqual(6, doc.Revisions.Count);
Assert.AreEqual("This is revision #1. \rThis is revision #2.", doc.GetText().Trim());

也可以看看