NumberingFormats 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义 NumberingFormats 类。

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

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

public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

type NumberingFormats = class
    inherit OpenXmlCompositeElement

Public Class NumberingFormats
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

NumberingFormats

注解

[ISO/IEC 29500-1 第 1 版]

numFmts (Number Formats)

此元素定义此工作簿中的数字格式，由一系列 numFmt 记录组成，其中每个 numFmt 记录定义一个特定的数字格式，指示如何设置单元格的格式和呈现数值。

[示例：

此单元格的格式设置为美元：

7fc8d8ee-f580-4e43-98d0-91cf9abd8243

表示此格式的 XML 显示 formatId 为“166”，解码的 formatCode 为 $#，##0.00

<numFmts count="1">  
  <numFmt numFmtId="166" formatCode="&quot;$&quot;#,##0.00"/>  
</numFmts>  

示例结束]

Number Format Codes

最多可以指定四个格式代码部分。 格式代码用分号分隔，按该顺序定义正数、负数、零值和文本的格式。 如果只指定了两个部分，则第一个部分用于正数和零，第二个部分用于负数。 如果只指定了一个部分，则将其用于所有数字。 若要跳过某个节，应写入该节的结束分号。

9e00b419-894b-4a01-aba5-c8c92db922a6

第一节“正数的格式”是当单元格值包含正数时应用于单元格的格式代码。

第二节“负数的格式”是当单元格值包含负数时应用于单元格的格式代码。

第三部分“零的格式”是当单元格值为零时应用于单元格的格式代码。

第四个（也是最后一个）部分“文本格式”是当单元格值为文本时应用于单元格的格式代码。

& (和) 文本运算符用于联接或连接两个值。

下表描述了可用于自定义数字格式的不同符号。

格式符号

说明和结果

0

数字占位符。 [示例：如果值 8.9 显示为 8.90，请使用格式 #.00 结束示例]

#

数字占位符。 此符号遵循与 0 符号相同的规则。 但是，如果键入的数字在小数点的任一侧的位数少于格式中的 # 符号，则应用程序不应显示额外的零。 [示例：如果自定义格式为 #.##，而单元格中为 8.9，则显示数字 8.9。 示例结束]

?

数字占位符。 此符号遵循与 0 符号相同的规则。 但是，应用程序应在小数点的两侧放置一个空间来表示微不足道的零，以便小数点在列中对齐。 [示例：自定义格式 0.0？ 对齐数字 8.9 和列的小数点。 示例结束]

. (period)

小数点。

%

百分比。 如果单元格包含介于 0 和 1 之间的数字，并且使用了自定义格式 0%，则应用程序应将该数字乘以 100 并在单元格中添加百分比符号。

， (逗号)

千位分隔符。 如果格式包含用数字符号 (#) 或零括起来的逗号，则应用程序应用逗号分隔千个。 占位符后面的逗号将数字缩放为 1000。 [示例：如果格式为 #.0，并且单元格值为 12,200,000，则显示数字 12.2。 示例结束]

E- E+ e- e+

科学记数法格式。 应用程序应在“E”符号右侧显示一个数字，该数字对应于移动小数点的位数。 [示例：如果格式为 0.00E+00，并且单元格中值为 12,200,000，则显示数字 1.22E+07。 如果数字格式为 #0.0E+0，则显示数字 12.2E+6。 示例结束]

$-+/():space

显示符号。 如果需要显示与这些符号之一不同的字符，请在字符前面加上反斜杠 (\) 。 或者，将字符括在引号中。 [示例：如果数字格式为 (000) ，并且值 12 位于单元格中，则显示数字 (012) 。 示例结束]

\

以 格式显示下一个字符。 应用程序不应显示反斜杠。 [示例：如果数字格式为 0\！，并且值 3 位于单元格中，则值为 3！ 显示。 示例结束]

*

将格式中的下一个字符重复足够的时间，以便将列填充到其当前宽度。 格式的一节中不能有一个以上的星号。 如果格式的一节中出现多个星号，则除最后一个星号外的所有星号均将被忽略。 [示例：如果数字格式为 0*x，并且值 3 位于单元格中，则显示值 3xxxxxx。 单元格中显示的 x 个字符数因列的宽度而异。 示例结束]

_ (下划线)

跳过下一个字符的宽度。 这对于在同一列的不同单元格中排列负值和正值很有用。 [示例：数字格式 _ (0.0_) ; (0.0) 将数字 2.3 与列对齐，即使负数用括号括起来也是如此。 示例结束]

"text"

显示引号内的任何文本。 [示例：当值 1.23 位于单元格中时，格式 0.00“美元”显示 1.23 美元。 示例结束]

@

文本占位符。 如果在单元格中键入文本，则单元格中的文本将采用 at 符号 (@) 显示的格式。 [示例：如果数字格式为“Bob”@“Smith” (包含引号) ，并且单元格中值为“John”，则显示值 Bob John Smith。 示例结束]

Text and spacing

同时显示文本和数字

若要在单元格中同时显示文本和数字，请将文本字符括在双引号 (“”) 或单个字符前面带有反斜杠 (\) 。 单引号不得用于表示文本。 双引号内或紧跟反斜杠的字符不得解释为格式代码词典的一部分：相反，它们应始终被视为文本字符串。 请记住，在格式代码的相应部分中包括字符。 [示例：使用格式 0.00 美元“盈余”;$-0.00“短缺”将正金额显示为“$125.74 盈余”，将负数显示为“$-125.74 短缺”。 end example]

显示以下字符时不使用引号。

$

美元符号

-

减号

+

加号

/

斜杠标记

(

左括号

)

右括号

:

冒号

!

感叹 号

^

自旋着色 (插入点)

&

与号

'

撇号

~

波形符

{

左大括号

}

右大括号

<

小于号

大于号

=

等号

空格字符

包含文本输入部分

如果包含，则文本部分应为数字格式的最后一节。 在 节中包含“at”符号 (@) ，精确显示单元格的文本值的位置。 如果文本部分省略了 @ 字符，则不会显示单元格中键入的文本。 若要始终使用键入的文本显示特定文本字符，请将附加文本括在双引号 (“”) 。 [示例：如果在单元格中键入了“June”，并且文本格式为“@ 的总收据”，则该单元格将显示“6 月的总收据”。 示例结束]

如果格式不包含文本部分，则单元格中输入的文本不受格式代码的影响。

添加空格

若要创建数字格式字符宽度的空格，请添加下划线，后跟字符。 [示例：当下划线后跟右括号（如 _) ）时，正数与括在括号中的负数正确对齐，因为正数在右括号字符的宽度后面显示空格。 示例结束]

重复字符

若要在格式中重复下一个字符以填充列宽，请在数字格式中包含星号 (*) 。 [示例：使用 0*- 在数字后包含足够的短划线以填充单元格，或使用 *0 在任何格式之前包含前导零。 示例结束]

Decimal places, spaces, colors, and conditions

包括小数位数和有效数字

若要使用小数点设置分数或数字的格式，请在节中包含以下数字占位符。 如果数字在小数点右侧的位数多于格式中的占位符，则数字将舍入到与占位符相同的小数位数。 如果小数点左侧的位数多于占位符，则会显示额外的数字。 如果格式仅包含小数点左侧的数字符号 (#) ，则小于 1 的数字以小数点开头。

# (数字符号) 仅显示有效数字，不显示微不足道的零。

0 (零) 如果数字的位数少于格式中的零，则显示微不足道的零。

? (问号) 在小数点的两侧添加微不足道零的空格，以便在使用固定宽度字体（如 Courier New）设置格式时，小数点对齐。 ? 还可用于具有不同数字数的分数。

显示内容

As

使用此代码

1234.59

1234.6

####.#

8.9

8.900

#.000

.631

0.6

0.#

121234.568

12.01234.57

#.0#

44.398102.652.8

44.398102.65 2.8 (与对齐的小数)

???.???

5.255.3

5 1/45 3/10 (与对齐分数)

# ???/???

显示千位分隔符

若要将逗号显示为千位分隔符或将数字缩放为 1,000 的倍数，请在数字格式中包含逗号。

显示内容

As

使用此代码

12000

12,000

#,###

12000

12

#,

12200000

12.2

0.0,,

指定颜色

若要设置格式部分的文本颜色，请在节的方括号中使用以下八种颜色之一的名称。 颜色代码应为 节中的第一项。

[黑色]

[蓝色]

[青色]

[绿色]

[Magenta]

[红色]

[白色]

[黄色]

可以使用颜色索引，而不是使用颜色的名称，如红色的 [Color3] 。 颜色的数字索引重新设置为 1 到 56 的范围，该范围按索引引用旧调色板。

[注意：默认的旧式调色板值在 §18.8.27 中列出。 在格式代码中，[Color1] 是指与 indexed=“8”关联的颜色，或默认) 的黑色 (，[Color2] 是指与 indexed=“9”关联的颜色，或默认) 白色 (，依此以 [Color56] 引用与 indexed=“63” 关联的颜色。 如果已从默认值自定义调色板，则与这些索引关联的颜色将反映这些自定义项。

指定条件

若要设置仅在数字满足指定条件时应用的数字格式，请将条件括在方括号中。 条件由比较运算符和值组成。 比较运算符包括： = 等于; > 大于; < 少于; >= 大于或等于、 <= 小于或等于和 <> 不等于。 [示例：以下格式显示小于或等于红色字体的数字和大于蓝色字体的数字。

[Red][<=100];[Blue][>100]  

示例结束]

如果单元格值不符合任何条件，则会在单元格宽度上显示井号 (“#”) 。

Currency, percentages, and scientific notation

包括货币符号

若要包含货币符号，请将货币符号放在显示时应的位置。

显示百分比

若要将数字显示为百分比 100—[示例：将 .08 显示为 8% 或 2.8 显示为 280% 结束示例]，请在数字格式中包含百分比符号 (%) 。

显示科学记数法

若要以科学格式显示数字，请在节中使用指数代码 — [示例：E、E+、e-或 e+。 示例结束]

如果格式在指数代码右侧包含零 (0) 或数字符号 (#) ，则应用程序以科学格式显示数字并插入“E”或“e”。 代码右侧的零或数字符号的数量决定了指数中的位数。 “E-”或“e-”由负指数放置减号。 “E+”或“e+”将减号置于负指数和正指数的加号。

Dates and times

显示天、月和年

显示内容

As

使用此代码

月

1–12

m

月

01–12

mm

月

1 月到 12 月

mmm

月

1 月到 12 月

mmmm

月

J-D

mmmmm

天

1–31

d

天

01–31

dd

天

周日-周六

ddd

天

星期日至星期六

dddd

年限

00–99

yy

年限

日期基最小值 –9999

yyyy

有关可能的日期基准的详细信息，请参阅 §18.17.4.1。

月份与分钟

如果在“h”或“hh”代码 (几小时后立即使用“m”或“mm”代码) ，) 或者紧接在“ss”代码 (几秒钟) 之前，应用程序应显示分钟而不是月份。

显示小时、分钟和秒

显示内容

As

使用此代码

小时

0–23

h

小时

00–23

hh

分钟

0–59

m

分钟

00–59

mm

秒

0–59

s

秒

00–59

ss

时间

h AM/PM

时间

h：mm AM/PM

时间

4：36：03 P

h：mm：ss A/P

时间

4:36:03.75

h：mm：ss.00

运行时间 (小时和分钟)

1:02

[h]：mm

运行时间 (分秒)

62:16

[mm]：ss

运行时间 (秒和百分之)

3735.80

[ss].00

分钟数与月份数

“m”或“mm”代码应紧接在“h”或“hh”代码之后或紧接在“ss”代码之前：否则，这些将显示为月份而不是分钟。

AM 和 PM

如果格式包含 AM 或 PM，则小时基于 12 小时制，其中“AM”或“A”表示从到晚的时间，“PM”或“P”表示从到午夜的时间。 否则，该小时基于 24 小时制。

日期和时间值非法

具有日期或时间格式且包含日期或时间值不符合指定要求的单元格应在整个单元格宽度上显示井号 (“#”) 。

International Considerations

格式代码

说明

r

仅限 ja-jp/zh-tw。

在 ja-jp 区域设置中加载时，代码将变为“ee”。

在 zh-tw 区域设置中加载时，代码将变为“e”。

Rr

仅限 ja-jp/zh-tw。

在 ja-jp 区域设置中加载时，代码将变为“gggee”。

在 zh-tw 区域设置中加载时，代码将变为“e”。

g

在 ja-jp 区域设置中加载时：单罗马字符皇帝统治

在 zh-tw (台湾加载时，仅) 区域设置：与“gg”相同。

gg

在 ja-jp 区域设置中加载时：单一汉字皇帝统治

在 zh-tw 区域设置中加载时：自 1911 ()

ggg

在 ja-jp 区域设置中加载时：图汉字皇帝统治

在 zh-tw 区域设置中加载时：自 1911 ()

e

在 ja-jp 区域设置中加载时：Era 年份

当 zh-tw (台湾只有) 区域设置时： 时代自 1912 年以来。 如果前面有“g”、“gg”或“ggg”，则 1912 年和 1912 年前的年份是特殊年份，否则 1912 年前的年份为公历。

其他区域设置：变为“yyyy”

Ee

在 ja-jp 区域设置中加载时：带前导零的 Era 年

在 zh-tw (台湾加载时，仅) 区域设置：自 1911 年以来的纪元年

其他区域设置：变为“yy”

b2

Hijri calander

b1

公历

[$USD-409]

指定货币和区域设置/日期系统/数字系统信息。

语法为 [$<Currency String-language>< info>]。 货币字符串是用作货币符号的字符串。 语言信息是以十六进制格式输入的 32 位值。

语言信息格式 (字节 3 是最重要的字节) ：

字节 0,1：16 位语言 ID (LID) 。

字节 2：日历类型。 高位表示使用指定的日历分析输入。

字节 3：数字系统类型。 高位表示使用指定的数字系统分析输入。

特殊语言信息值：

0xf800：系统长日期格式

0xf400：系统时间格式

父元素
styleSheet (§18.8.39)

子元素	第
numFmt (数字格式)	§18.8.30

属性	说明
count (Number Format Count)	数字格式元素的计数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。

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

ISO/IEC29500：2008。

构造函数

NumberingFormats()	初始化 NumberingFormats 类的新实例。
NumberingFormats(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 NumberingFormats 类的新实例。
NumberingFormats(OpenXmlElement[])	使用指定的子元素初始化 NumberingFormats 类的新实例。
NumberingFormats(String)	从外部 XML 初始化 NumberingFormats 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Count	数字格式计数 表示架构中的以下属性：count
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
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)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
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)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
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)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	定义 NumberingFormats 类。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 x：numFmts。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)