NumberingFormat 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

数字格式。

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

当对象序列化为 xml 时，其限定名称为 x：numFmt。

public class NumberingFormat : DocumentFormat.OpenXml.OpenXmlLeafElement

type NumberingFormat = class
    inherit OpenXmlLeafElement

Public Class NumberingFormat
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

NumberingFormat

注解

[ISO/IEC 29500-1 第 1 版]

numFmt (数字格式)

此元素指定数字格式属性，这些属性指示如何格式化和呈现单元格的数值。

以下是格式的列表，其 formatCode 值是隐式的，而不是显式保存在文件中。 在这种情况下，numFmtId 值写入 xf 记录，但不写入相应的 numFmt 元素。 可以根据实现应用程序的 UI 语言，以不同的方式解释其中一些 ID。

未在列表中指定的 ID（如 5、6、7 和 8）应遵循 formatCode 属性指定的数字格式。

所有语言

ID

formatCode

0

一般信息

1

0

2

0.00

3

#,##0

4

#,##0.00

9

0%

10

0.00%

11

0.00E+00

12

# ?/?

13

# ??/??

14

mm-dd-yy

15

d-mmm-yy

16

d-mmm

17

mmm-yy

18

h：mm AM/PM

19

h：mm：ss AM/PM

20

h：mm

21

h：mm：ss

22

m/d/yy h：mm

37

#，##0 ; (#，##0)

38

#,##0 ;[Red] (#，##0)

39

#，##0.00; (#，##0.00)

40

#,##0.00;[Red] (#，##0.00)

45

mm：ss

46

[h]：mm：ss

47

mmss.0

48

##0.0E+0

49

@

“常规”格式

有关“常规”数字格式的一些其他注释是合适的。

单元格使用“常规”格式设置的主要目标是在没有用户指定的指导的情况下呈现单元格内容，以达到应用程序的最佳功能。

Alignment

为从左到右模式指定的 ()

字符串：左对齐

布尔值/错误值：居中

数字：右对齐

日期：不要遵循“常规”格式，而是自动转换为日期格式。

Numbers

应用程序应尝试显示最多 11 位数字 (小数点) 。 如果数字太大，应用程序应尝试显示指数格式。 如果数字包含过多有效数字，应截断显示。 最佳显示方法基于可用的单元格宽度。 如果数字不能在可用宽度中使用任何这些格式显示，则应用程序应在单元格的宽度上显示“#”。

切换到指数格式的条件：

单元格值应至少具有 xE-xx 的 5 位数字

如果指数大于允许的大小，则浮点数无法拟合，因此请尝试指数表示法。

同样，对于负指数，如果即使有一个 (浮点格式的非零) 位数的空间，检查。

最后，如果浮点格式中没有空间 (负指数) 的所有有效数字，指数格式应显示更多的数字（如果指数小于 -3）。 (3 是因为 E-xx 需要 4 个字符，而浮点中的前导 0 只占用 1 个字符。因此，对于小于 -3 的指数，有 3 个以上的附加前导 0，足以补偿 E-xx.)

浮点规则：

对于单元格中的常规格式设置，单元格显示的最大总长度为 11，不包括负号，但包括前导零和小数分隔符。

zh-tw和zh-cn

ID

zh-tw formatCode

zh-cn formatCode

27

[$-404]e/m/d

yyyy“年”m“月”

28

[$-404]e“年”m“月”d“日”

m“月”d“日”

29

[$-404]e“年”m“月”d“日”

m“月”d“日”

30

m/d/yy

m-d-yy

31

yyyy“年”m“月”d“日”

yyyy“年”m“月”d“日”

32

hh“時”mm“分”

h“时”mm“分”

33

hh“時”mm“分”ss“秒”

h“时”mm“分”ss“秒”

34

上午/下午h“時”mm“分”

上午/下午h“时”mm“分”

35

上午/下午hh“時”mm“分”ss“秒”

上午/下午h“时”mm“分”ss“秒”

36

[$-404]e/m/d

yyyy“年”m“月”

50

[$-404]e/m/d

yyyy“年”m“月”

51

[$-404]e“年”m“月”d“日”

m“月”d“日”

52

上午/下午h“時”mm“分”

yyyy“年”m“月”

53

上午/下午hh“時”mm“分”ss“秒”

m“月”d“日”

54

[$-404]e“年”m“月”d“日”

m“月”d“日”

55

上午/下午h“時”mm“分”

上午/下午h“时”mm“分”

56

上午/下午hh“時”mm“分”ss“秒”

上午/下午h“时”mm“分”ss“秒”

57

[$-404]e/m/d

yyyy“年”m“月”

58

[$-404]e“年”m“月”d“日”

m“月”d“日”

zh-tw和zh-cn (为语言字形提供 unicode 值，这些标志符号出现在)

ID

zh-tw formatCode

zh-cn formatCode

27

[$-404]e/m/d

yyyy“5E74”m“6708”

28

[$-404]e“5E74”m“6708”d“65E5”

m“6708”d“65E5”

29

[$-404]e“5E74”m“6708”d“65E5”

m“6708”d“65E5”

30

m/d/yy

m-d-yy

31

yyyy“5E74”m“6708”d“65E5”

yyyy“5E74”m“6708”d“65E5”

32

hh“6642”mm“5206”

h“65F6”mm“5206”

33

hh“6642”mm“5206”ss“79D2”

h“65F6”mm“5206”ss“79D2”

34

4E0A5348/4E0B5348h“6642”mm“5206”

4E0A5348/4E0B5348h“65F6”mm“5206”

35

4E0A5348/4E0B5348h“6642”mm“5206”ss“79D2”

4E0A5348/4E0B5348h“65F6”mm“5206”ss“79D2”

36

[$-404]e/m/d

yyyy“5E74”m“6708”

50

[$-404]e/m/d

yyyy“5E74”m“6708”

51

[$-404]e“5E74”m“6708”d“65E5”

m“6708”d“65E5”

52

4E0A5348/4E0B5348h“6642”mm“5206”

yyyy“5E74”m“6708”

53

4E0A5348/4E0B5348h“6642”mm“5206”ss“79D2”

m“6708”d“65E5”

54

[$-404]e“5E74”m“6708”d“65E5”

m“6708”d“65E5”

55

4E0A5348/4E0B5348h“6642”mm“5206”

4E0A5348/4E0B5348h“65F6”mm“5206”

56

4E0A5348/4E0B5348h“6642”mm“5206”ss“79D2”

4E0A5348/4E0B5348h“65F6”mm“5206”ss“79D2”

57

[$-404]e/m/d

yyyy“5E74”m“6708”

58

[$-404]e“5E74”m“6708”d“65E5”

m“6708”d“65E5”

ja-jp和ko-kr

ID

ja-jp formatCode

ko-kr formatCode

27

[$-411]ge.m.d

yyyy“年” mm“月” d“日”

28

[$-411]ggge“年”m“月”d“日”

mm-dd

29

[$-411]ggge“年”m“月”d“日”

mm-dd

30

m/d/yy

mm-dd-yy

31

yyyy“年”m“月”d“日”

yyyy“년” mm“월” dd“일”

32

h“時”mm“分”

h“시” mm“분”

33

h“時”mm“分”ss“秒”

h“시” mm“분” ss“초”

34

yyyy“年”m“月”

yyyy-mm-dd

35

m“月”d“日”

yyyy-mm-dd

36

[$-411]ge.m.d

yyyy“年” mm“月” d“日”

50

[$-411]ge.m.d

yyyy“年” mm“月” d“日”

51

[$-411]ggge“年”m“月”d“日”

mm-dd

52

yyyy“年”m“月”

yyyy-mm-dd

53

m“月”d“日”

yyyy-mm-dd

54

[$-411]ggge“年”m“月”d“日”

mm-dd

55

yyyy“年”m“月”

yyyy-mm-dd

56

m“月”d“日”

yyyy-mm-dd

57

[$-411]ge.m.d

yyyy“年” mm“月” d“日”

58

[$-411]ggge“年”m“月”d“日”

mm-dd

ja-jp和ko-kr (为语言字形提供 unicode 值，这些标志符号出现在)

ID

ja-jp formatCode

ko-kr formatCode

27

[$-411]ge.m.d

yyyy“5E74” mm“6708” dd“65E5”

28

[$-411]ggge“5E74”m“6708”d“65E5”

mm-dd

29

[$-411]ggge“5E74”m“6708”d“65E5”

mm-dd

30

m/d/yy

mm-dd-yy

31

yyyy“5E74”m“6708”d“65E5”

yyyy“B144” mm“C6D4” dd“C77C”

32

h“6642”mm“5206”

h“C2DC” mm“BD84”

33

h“6642”mm“5206”ss“79D2”

h“C2DC” mm“BD84” ss “CD08”

34

yyyy“5E74”m“6708”

yyyy-mm-dd

35

m“6708”d“65E5”

yyyy-mm-dd

36

[$-411]ge.m.d

yyyy“5E74” mm“6708” dd“65E5”

50

[$-411]ge.m.d

yyyy“5E74” mm“6708” dd“65E5”

51

[$-411]ggge“5E74”m“6708”d“65E5”

mm-dd

52

yyyy“5E74”m“6708”

yyyy-mm-dd

53

m“6708”d“65E5”

yyyy-mm-dd

54

[$-411]ggge“5E74”m“6708”d“65E5”

mm-dd

55

yyyy“5E74”m“6708”

yyyy-mm-dd

56

m“6708”d“65E5”

yyyy-mm-dd

57

[$-411]ge.m.d

yyyy“5E74” mm“6708” dd“65E5”

58

[$-411]ggge“5E74”m“6708”d“65E5”

mm-dd

th-th

ID

th-th formatCode

59

t0

60

t0.00

61

t#，##0

62

t#，##0.00

67

t0%

68

t0.00%

69

t# ?/?

70

t# ??/??

71

ว/ด/ปปปป

72

ว-ดดด-ปป

73

ว-ดดด

74

ดดด-ปป

75

ช:นน

76

ช:นน:ทท

77

ว/ด/ปปปป ช:นน

78

นน:ทท

79

[ช]:นน:ทท

80

นน:ทท.0

81

d/m/bb

第 ( 个为语言字形提供 unicode 值，这些标志符号出现的位置)

ID

th-th formatCode

59

t0

60

t0.00

61

t#，##0

62

t#，##0.00

67

t0%

68

t0.00%

69

t# ?/?

70

t# ??/??

71

0E27/0E14/0E1B0E1B0E1B

72

0E27-0E140E140E14-0E1B0E1B

73

0E27-0E140E140E14

74

0E140E140E14-0E1B0E1B

75

0E0A：0E190E19

76

0E0A：0E190E19：0E170E17

77

0E27/0E14/0E1B0E1B0E1B0E1B 0E0A：0E190E19

78

0E190E19：0E170E17

79

[0E0A]：0E190E19：0E170E17

80

0E190E19：0E170E17.0

81

d/m/bb

父元素
dxf (§18.8.14) ;ndxf (§18.11.1.4) ;numFmts (§18.8.31) ;odxf (§18.11.1.6)

属性	说明
formatCode (Number Format Code)	此数字格式的数字格式代码。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
numFmtId (数字格式 ID)	主样式记录的 ID (xf 的) 引用此数字格式。 此属性的可能值由 ST_NumFmtId 简单类型 (§18.18.47) 定义。

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

ISO/IEC29500：2008。

构造函数

NumberingFormat()

初始化 NumberingFormat 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
FormatCode	数字格式代码 表示架构中的以下属性：formatCode
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafElement)
InnerText	获取或设置节点及其所有子级的串联值。 (继承自 OpenXmlElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafElement)
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
NumberFormatId	数字格式 ID 表示架构中的以下属性：numFmtId
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
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 时，其限定名称为 x：numFmt。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)