Id

StructuredDocumentTagRangeStart.Id property

为此结构化文档标签指定一个唯一的只读持久数字 ID。

public int Id { get; }

评论

Id属性应遵循以下规则：

  • 仅当整个 document 被克隆时，文档才应保留结构化文档标签 IDClone。
  • 期间ImportNode如果导入不会与目标文档中的其他结构化文档标签 ID 发生冲突，则应保留 ID。
  • 如果多个结构化文档标签节点为 Id 属性指定了相同的十进制数值， 则文档中的第一个结构化文档标签应保留此原始 Id， 并且所有后续结构化文档标签节点都应在加载文档时分配新的标识符。
  • 在独立结构化文档标签期间INodeCloningListener)操作将为克隆的结构化文档标签节点生成新的唯一ID 。
  • 如果源文档中未指定 Id，则在加载文档时，结构化文档标签节点应分配一个新的唯一标识符。

例子

展示如何获取多节结构化文档标签的属性。

Document doc = new Document(MyDir + "Multi-section structured document tags.docx");

StructuredDocumentTagRangeStart rangeStartTag =
    doc.GetChildNodes(NodeType.StructuredDocumentTagRangeStart, true)[0] as StructuredDocumentTagRangeStart;
StructuredDocumentTagRangeEnd rangeEndTag =
    doc.GetChildNodes(NodeType.StructuredDocumentTagRangeEnd, true)[0] as StructuredDocumentTagRangeEnd;

Console.WriteLine("StructuredDocumentTagRangeStart values:");
Console.WriteLine($"\t|Id: {rangeStartTag.Id}");
Console.WriteLine($"\t|Title: {rangeStartTag.Title}");
Console.WriteLine($"\t|PlaceholderName: {rangeStartTag.PlaceholderName}");
Console.WriteLine($"\t|IsShowingPlaceholderText: {rangeStartTag.IsShowingPlaceholderText}");
Console.WriteLine($"\t|LockContentControl: {rangeStartTag.LockContentControl}");
Console.WriteLine($"\t|LockContents: {rangeStartTag.LockContents}");
Console.WriteLine($"\t|Level: {rangeStartTag.Level}");
Console.WriteLine($"\t|NodeType: {rangeStartTag.NodeType}");
Console.WriteLine($"\t|RangeEnd: {rangeStartTag.RangeEnd}");
Console.WriteLine($"\t|Color: {rangeStartTag.Color.ToArgb()}");
Console.WriteLine($"\t|SdtType: {rangeStartTag.SdtType}");
Console.WriteLine($"\t|FlatOpcContent: {rangeStartTag.WordOpenXML}");
Console.WriteLine($"\t|Tag: {rangeStartTag.Tag}\n");

Console.WriteLine("StructuredDocumentTagRangeEnd values:");
Console.WriteLine($"\t|Id: {rangeEndTag.Id}");
Console.WriteLine($"\t|NodeType: {rangeEndTag.NodeType}");

也可以看看

StructuredDocumentTagRangeStart.Color StructuredDocumentTagRangeStart.IsShowingPlaceholderText