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 не записывается. Некоторые из этих идентификаторов могут интерпретироваться по-разному в зависимости от языка пользовательского интерфейса реализующего приложения.

Идентификаторы, не указанные в листинге, например 5, 6, 7 и 8, должны соответствовать числовой формату, заданному атрибутом formatCode.

Все языки

ИД

formatCode

0

Общие

1

0

2

0.00

3

#,##0

4

#,##0.00

9

0%

10

0.00%

11

0.00E+00

12

# ?/?

13

# ??/??

14

мм-дд-гг

15

d-mmm-yy

16

d-mmm

17

ммм-гг

18

ч:мм AM/PM

19

ч:мм:сс AM/PM

20

ч:мм

21

ч:мм:сс

22

m/d/гг ч:мм

37

#,##0 ;(#,##0)

38

#,##0 ; [Красный] (#,##0)

39

#,##0.00; (#,##0.00)

40

#,##0.00; [Красный] (#,##0.00)

45

mm:ss

46

[ч]:мм:сс

47

mmss.0

48

##0.0E+0

49

@

"Общий" формат

Некоторые дополнительные комментарии к числовом формату "Общий" являются подходящими.

Основная цель, когда ячейка использует форматирование "Общее", заключается в том, чтобы отрисовка содержимого ячейки без указаний пользователем, чтобы обеспечить наилучшие возможности приложения.

Alignment

(Указано для режима слева направо)

Строки: выравнивание по левому краю

Логические значения или значения ошибок: по центру

Числа: по правому краю

Даты: не следует формату "Общий", вместо этого автоматически преобразуйте в формат даты.

Number;

Приложение должно попытаться отобразить полное число до 11 цифр (в т. е. запятую). Если число слишком велико, приложение должно попытаться отобразить экспоненциальный формат. Если число содержит слишком много значаных цифр, дисплей должен быть усечен. Оптимальный метод отображения основан на доступной ширине ячейки. Если число не может быть отображено в любом из этих форматов в доступной ширине, приложение должно отображать "#" по ширине ячейки.

Условия для перехода на экспоненциальный формат:

Значение ячейки должно содержать не менее пяти цифр для xE-xx.

Если экспонента больше допустимого размера, число с плавающей запятой не может поместиться, поэтому попробуйте экспоненциальную нотацию.

Аналогичным образом, для отрицательных экспонент проверка, если имеется место даже для одной (ненулевой) цифры в формате с плавающей запятой.

Наконец, если нет места для всех значимых цифр в формате с плавающей запятой (для отрицательной экспоненты), экспоненциальный формат должен отображать больше цифр, если экспонента меньше -3. (Значение 3 связано с тем, что E-xx принимает 4 символа, а в начале 0 в плавающей точке принимает только 1 символ. Таким образом, для экспоненты меньше -3 существует более 3 дополнительных ведущих 0's, более чем достаточно, чтобы компенсировать размер E-xx.)

Правило с плавающей запятой:

Для общего форматирования в ячейках максимальная общая длина для отображения ячейки составляет 11, не включая отрицательный знак, но включает начальные нули и десятичный разделитель.

zh-twиzh-cn

ИД

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

上午/下午hh"時"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

上午/下午hh"時"mm"分"

yyyy"年"m"月"

53

上午/下午hh"時"mm"分"ss"秒"

m"月"d"日"

54

[$-404]e"年"m"月"d"日"

m"月"d"日"

55

上午/下午hh"時"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(со значениями Юникода, предоставленными для языковых глифов, где они встречаются)

ИД

zh-tw formatCode

zh-cn formatCode

27

[$-404]e/m/d

гггг"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

гггг"5E74"m"6708"

50

[$-404]e/m/d

гггг"5E74"m"6708"

51

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

m"6708"d"65E5"

52

4E0A5348/4E0B5348h"6642"mm"5206"

гггг"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

гггг"5E74"m"6708"

58

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

m"6708"d"65E5"

ja-jpиko-kr

ИД

ja-jp formatCode

ko-kr formatCode

27

[$-411]ge.m.d

yyyy"年" mm"月" dd"日"

28

[$-411]ggge"年"m"月"d"日"

мм-дд

29

[$-411]ggge"年"m"月"d"日"

мм-дд

30

m/d/yy

мм-дд-гг

31

yyyy"年"m"月"d"日"

yyyy"년" mm"월" dd"일"

32

h"時"mm"分"

h"시" mm"분"

33

h"時"mm"分"ss"秒"

h"시" mm"분" ss"초"

34

yyyy"年"m"月"

гггг-мм-дд

35

m"月"d"日"

гггг-мм-дд

36

[$-411]ge.m.d

yyyy"年" mm"月" dd"日"

50

[$-411]ge.m.d

yyyy"年" mm"月" dd"日"

51

[$-411]ggge"年"m"月"d"日"

мм-дд

52

yyyy"年"m"月"

гггг-мм-дд

53

m"月"d"日"

гггг-мм-дд

54

[$-411]ggge"年"m"月"d"日"

мм-дд

55

yyyy"年"m"月"

гггг-мм-дд

56

m"月"d"日"

гггг-мм-дд

57

[$-411]ge.m.d

yyyy"年" mm"月" dd"日"

58

[$-411]ggge"年"m"月"d"日"

мм-дд

ja-jpиko-kr(со значениями Юникода, предоставленными для языковых глифов, где они встречаются)

ИД

ja-jp formatCode

ko-kr formatCode

27

[$-411]ge.m.d

гггг"5E74" мм"6708" дд"65E5"

28

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

мм-дд

29

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

мм-дд

30

m/d/yy

мм-дд-гг

31

yyyy"5E74"m"6708"d"65E5"

гггг"B144" мм"C6D4" дд"C77C"

32

h"6642"mm"5206"

h"C2DC" mm"BD84"

33

h"6642"mm"5206"ss"79D2"

h"C2DC" mm"BD84" ss"CD08"

34

гггг"5E74"m"6708"

гггг-мм-дд

35

m"6708"d"65E5"

гггг-мм-дд

36

[$-411]ge.m.d

гггг"5E74" мм"6708" дд"65E5"

50

[$-411]ge.m.d

гггг"5E74" мм"6708" дд"65E5"

51

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

мм-дд

52

гггг"5E74"m"6708"

гггг-мм-дд

53

m"6708"d"65E5"

гггг-мм-дд

54

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

мм-дд

55

гггг"5E74"m"6708"

гггг-мм-дд

56

m"6708"d"65E5"

гггг-мм-дд

57

[$-411]ge.m.d

гггг"5E74" мм"6708" дд"65E5"

58

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

мм-дд

th-th

ИД

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

th-th(со значениями Юникода, предоставленными для языковых глифов, где они встречаются)

ИД

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 (код числового формата)	Код числового формата для этого числового формата. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).
numFmtId (идентификатор числового формата)	Идентификатор, используемый записями стилей master (xf) для ссылки на этот формат чисел. Возможные значения для этого атрибута определяются простым типом ST_NumFmtId (§18.18.47).

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_NumFmt) находится в §A.2. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

NumberingFormat()

Инициализирует новый экземпляр класса NumberingFormat.

Свойства

ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Возвращает первый дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
FormatCode	Код числового формата Представляет следующий атрибут в схеме: formatCode
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlLeafElement)
InnerText	Возвращает или задает объединенные значения узла и всех его дочерних элементов. (Унаследовано от OpenXmlElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
LastChild	Возвращает последний дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
NumberFormatId	Идентификатор числового формата Представляет следующий атрибут в схеме: 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)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от 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. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от 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)