NumberingId Class

Numbering Definition Instance Reference.When the object is serialized out as xml, its qualified name is w:numId.

Inheritance Hierarchy


Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)


Public Class NumberingId _
    Inherits NonNegativeDecimalNumberType
Dim instance As NumberingId
public class NumberingId : NonNegativeDecimalNumberType


[ISO/IEC 29500-1 1st Edition]

17.9.19 numId (Numbering Definition Instance Reference)

This element specifies the numbering definition instance which shall be used for the given parent numbered paragraph in the WordprocessingML document.

A value of 0 for the val attribute shall never be used to point to a numbering definition instance, and shall instead only be used to designate the removal of numbering properties at a particular level in the style hierarchy (typically via direct formatting).

[Example: Consider the WordprocessingML below for an example numbered paragraph:

<w:ilvl w:val="0" />
<w:numId w:val="5" />

This paragraph references a numbering definition instance with a numId attribute of 5, as follows:

<w:num w:numId="5">
<w:abstractNumId w:val="4" />

The numbering definition instance reference specifies the given numbering definition instance to be applied to the given paragraph, which itself inherits its properties from abstract numbering definition with abstractNumId of 4. end example]

Parent Elements

numPr (§



val (Decimal Number Value)

Specifies that the contents of this attribute contains a decimal number.

The contents of this decimal number are interpreted based on the context of the parent XML element.

[Example: Consider the following numeric WordprocessingML property of simple type ST_DecimalNumber:

<… w:val="1512645511" />

The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§17.18.10).

[Note: The W3C XML Schema definition of this element’s content model (CT_DecimalNumber) is located in §A.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also


NumberingId Members

DocumentFormat.OpenXml.Wordprocessing Namespace