NumberingChange 类

定义

命名空间:

DocumentFormat.OpenXml.Wordprocessing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

上一个段落编号属性。

此类在 Office 2007 及更高版本中可用。

将对象序列化为 xml 时，其限定名称为 w：numberingChange。

public class NumberingChange : DocumentFormat.OpenXml.OpenXmlLeafElement

type NumberingChange = class
    inherit OpenXmlLeafElement

Public Class NumberingChange
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

NumberingChange

注解

[ISO/IEC 29500-1 第 1 版]

numberingChange (Previous Numbering Field Properties)

此元素指定在添加其他 LISTNUM 字段并跟踪修订时，在 WordprocessingML 文档中 (第 1 部分 §17.16.5.33) 的 LISTNUM 字段显示的编号的先前状态。

[理由： LISTNUM 字段提供的旧编号机制依赖于文档的运行内容中是否存在字段，而不是作为段落属性 (，因为编号通常) 表示。 因此，这些字段必须将其以前的状态存储为编号字段的字段字符的唯一修订类型。 结束理由]

如果为类型不为 LISTNUM 的字段提供此元素，其字段代码 (第 1 部分§17.16.5) ，则此属性将被忽略。

[示例：请考虑包含单个 LISTNUM 字段的以下段落，如下所示：

5ccbfcbb-0568-4f98-b9e6-bc9b07df5295

如果在文档的前面添加了另一个 LISTNUM 字段，则其计算结果为不同的数字，如下所示：

5df1502e-4833-48c7-aa49-517de8059a13

字段结果的此修订将按如下方式存储在 WordprocessingML 中：

<w:fldChar w:fldCharType="begin">  
  <w:numberingChange w:id="0" … w:original="1." />  
</w:fldChar>  
<w:r>  
  <w:instrText>LISTNUM</w:instrText>  
</w:r>  
<w:fldChar w:fldCharType="separate"/>  
<w:r>  
  <w:t>2.</w:t>  
</w:r>  
<w:fldChar w:fldCharType="end" />  

numberingChange 元素指定修改了此 LISTNUM 字段生成的编号，并将此更改跟踪为修订。 以前的编号结果 1. 缓存在原始属性中。 示例结束]

对于编号字段，原始属性应指定由 WordprocessingML 文档中的父 LISTNUM 字段显示的先前编号。 此信息是修订前编号状态的性能增强缓存，使应用程序能够显示以前的状态，而无需重新计算文档中的所有 LISTNUM 字段。

如果省略此属性，则不会隐含以前的编号值，并且应用程序可以选择计算此值，或者不显示以前的编号值。

[示例：请考虑以下段落，其中包含带有修订的单个 LISTNUM 字段，如下所示：

5df1502e-4833-48c7-aa49-517de8059a13

字段结果的此修订将按如下方式存储在 WordprocessingML 中：

<w:fldChar w:fldCharType="begin">  
  <w:numberingChange w:id="0" … w:original="1." />  
</w:fldChar>  

原始属性指定字段的上一个编号值为 1。end example]

父元素
fldChar (第 1 部分§17.16.18)

[注意：此元素的内容模型 (CT_TrackChangeNumbering) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

[ISO/IEC 29500-1 第 1 版]

numberingChange (Previous Paragraph Numbering Properties)

此元素指定在跟踪修订时段落上编号的先前状态。

[理由：此机制仅用于为旧字处理应用程序生成的编号修订提供存储，建议应用程序使用 pPrChange 元素将这些更改存储为段落属性的更改。 结束理由]

[示例：考虑使用阿拉伯数字作为编号的以下列表，如下所示：

f1e61028-5796-4a3c-aaeb-f786fa603b64

请考虑将编号定义从阿拉伯数字更改为罗马数字的修订，如下所示：

e9f215fe-31e8-463c-a9b7-1f97d607869b

编号定义的此修订将按如下方式存储在 WordprocessingML 中：

<w:p>  
<w:pPr>  
<w:numPr>  
<w:ilvl w:val="0" />  
<w:numId w:val="1" />  
<w:numberingChange w:id="0" … w:original="%1:1:0:." />  
</w:numPr>  
</w:pPr>  
<w:r>  
<w:t>one</w:t>  
</w:r>  
</w:p>  
<w:p>  
<w:pPr>  
<w:numPr>  
<w:ilvl w:val="0" />  
<w:numId w:val="1" />  
<w:numberingChange w:id="1" … w:original="%1:2:0:." />  
</w:numPr>  
</w:pPr>  
<w:r>  
<w:t>two</w:t>  
</w:r>  
</w:p>  
<w:p>  
<w:pPr>  
<w:numPr>  
<w:ilvl w:val="0" />  
<w:numId w:val="1" />  
<w:numberingChange w:id="2" … w:original="%1:3:0:." />  
</w:numPr>  
</w:pPr>  
<w:r>  
<w:t>three</w:t>  
</w:r>  
</w:p>  

numberingChange 元素指定已修改编号定义，并将此更改作为修订进行跟踪。 以前的阿拉伯数字编号定义缓存在原始属性中。 示例结束]

对于段落编号，原始属性应在跟踪修订时为 WordprocessingML 文档中的单个文本段落指定先前的编号定义。

原始值表示为单独的编号级别定义，定义如下：

<%[numbering level]:[nfc value]:[numbering format]:[separator]>[repeat if more than one level]  

其中

• 编号级别 - 为其定义编号定义的级别

• nfc 值 – 特定编号级别的编号样式的值

• 编号格式 – 编号格式的 nfc 值，如下表中引用。

• 分隔符 - 用于分隔编号级别定义的分隔符

编号格式值映射如下：

nfc 值

ST_NumberFormat枚举等效项

0

十进制

1

upperRoman

2

lowerRoman

3

upperLetter

4

lowerLetter

5

序

6

cardinalText

7

ordinalText

8

十六进制

9

芝加哥

10

ideographDigital

11

japaneseCounting

12

Aiueo

13

Iroha

14

decimalFullWidth

15

decimalHalfWidth

16

japaneseLegal

17

japaneseDigitalTenThousand

18

decimalEnclosedCircle

19

decimalFullWidth2

20

aiueoFullWidth

21

irohaFullWidth

22

decimalZero

23

子弹

24

ganada

25

chosung

26

decimalEnclosedFullstop

27

decimalEnclosedParen

28

decimalEnclosedCircleChinese

29

ideographEnclosedCircle

30

ideographTraditional

31

ideographZodiac

32

ideographZodiacTraditional

33

taiwaneseCounting

34

ideographLegalTraditional

35

taiwaneseCountingThousand

36

taiwaneseDigital

37

chineseCounting

38

chineseLegalSimplified

39

chineseCountingThousand

40

应用程序定义。 可以忽略。

41

koreanDigital

42

koreanCounting

43

koreanLegal

44

koreanDigital2

45

希伯来语1

46

arabicAlpha

47

希伯来语2

48

arabicAbjad

49

印地语Vowels

50

印地语Consonants

51

印地语Numbers

52

印地语Counting

53

thaiLetters

54

thaiNumbers

55

thaiCounting

56

vietnameseCounting

57

numberInDash

58

russianLower

59

russianUpper

60 或更高

应用程序定义。 可以忽略。

[示例：请考虑以下编号段落，其中编号定义在修订被跟踪时已更改，如下所示：

1295cca3-f9de-4aec-9347-8baae6e0f1b0

编号段落的此修订将按如下方式存储在 WordprocessingML 中：

<w:numPr>  
  …  
  <w:numberingChange … w:original="%1:1:0:.%2:1:2:.%3:1:0:." />  
</w:numPr>  

在上面的示例中，原始编号定义中有三个级别，因此需要三个编号级别定义来表示原始编号定义。

第一个级别由 %1 指定，并表示它是数字值 1 ，采用 nfc 格式 0 (阿拉伯语) 。

原始属性指定以前的编号定义由值为 1.i.1 的三个级别组成。end example]

父元素
numPr (第 1 部分§17.3.1.19)

[注意：此元素的内容模型 (CT_TrackChangeNumbering) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

ISO/IEC29500：2008。

构造函数

NumberingChange()

初始化 NumberingChange 类的新实例。

属性

Author	author 表示架构中的以下属性：w：author
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Date	date 表示架构中的以下属性：w：date
DateUtc	dateUtc，此属性仅在 Microsoft365 及更高版本中可用。 表示架构中的以下属性：w16du：dateUtc
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafElement)
Id	批注标识符 表示架构中的以下属性：w：id
InnerText	获取或设置节点及其所有子级的串联值。 (继承自 OpenXmlElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafElement)
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
Original	源语言 表示架构中的以下属性：w：original
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素列表中指定索引处插入指定的元素。 (继承自 OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子元素列表的开头插入指定的元素。 (继承自 OpenXmlElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlLeafElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	从当前元素的子元素列表中删除指定的子元素。 (继承自 OpenXmlElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将子元素替换为当前元素的子元素列表中的另一个子元素。 (继承自 OpenXmlElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	上一个段落编号属性。 此类在 Office 2007 及更高版本中可用。 将对象序列化为 xml 时，其限定名称为 w：numberingChange。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)