c# - 为 OpenXML 文档中的新书签定义正确的 ID

Question

我正在编写一个 POC 应用程序，我希望能够在其中根据各种条件在 Word 文档中动态创建书签。

到目前为止，我已经设法实际创建和添加 BookmarkStart 和 BookmarkEnd 元素，但我正在尝试弄清楚应该如何设置“Id”属性。

在这方面我能找到的唯一规范是来自 MSDN 的 BookmarkStart 元素示例:

id (Annotation Identifier)
Specifies a unique identifier for an annotation within a WordprocessingML document. The restrictions on the id attribute, if any, are defined by the parent XML element.
If this attribute is omitted, then the document is non-conformant.
[Example: Consider an annotation represented using the following WordprocessingML fragment:
<… w:id="1" … >
…
</…>
The id attribute specifies that the ID of the current annotation is 1. This value is used to uniquely identify this annotation within the document content. end example]
The possible values for this attribute are defined by the ST_DecimalNumber simple type (§17.18.10).

所以，我知道它必须是一个数字，它是强制性的，而且 ID 必须是唯一的(呃!)。现在，它应该只在书签元素之间或在定义 id 的所有元素之间是唯一的吗？我应该如何制作这样的身份证件？我正在考虑使用 Linq 将所有 id 获取为数值(整数？对我来说“小数”意味着 float )然后将 1 加到最大值，但这似乎有点极端。

到目前为止，我的解决方案包含以下功能:

private static string ComputeNewId(OpenXmlElement root)
{
    return ((from b in root.Descendants<BookmarkStart>() select Decimal.Parse(b.Id)).Max() + 1).ToString();
}

到目前为止它似乎在工作，但老实说我不知道​​从长远来看这是否会可靠，因此非常欢迎任何有关此的额外信息。

谢谢大家。

Answer 1

我会尝试依次回答您的每个问题:

is it supposed to be unique only between bookmark elements, or between all elements defining an id?

Id 只需要在 BoookmarkStart 元素中是唯一的。 BookmarkStart必须有一个相应的BookmarkEnd具有相同的 Id，否则文档不兼容。

§17.13.6.2 书签开始状态:

This element specifies the start of a bookmark within a WordprocessingML document. This start marker is matched with the appropriately paired end marker by matching the value of the id attribute from the associated bookmarkEnd element.

And how should I produce such an id?

获取当前最大的 Id 并添加一个是明智的做法。您可能只找到一次最大值并从那时起存储它，但与您已经完成的相比，这不会产生巨大差异我不会想到。

integers? to me "Decimal" implies floating-point

ST_DecimalNumber 只允许整数。我想decimal例如，是对以 10 为底数而不是十六进制或二进制数的引用。

来自第 17.18.10 节(强调我的):

This simple type specifies that its contents contain a whole decimal number (positive or negative), whose contents are interpreted based on the context of the parent XML element.

接着说:

This simple type's contents are a restriction of the W3C XML Schema integer datatype.