Characteristic class
Collapse the table of content
Expand the table of content

Characteristic class

Office 2013 and later

Single Characteristic.When the object is serialized out as xml, its qualified name is ac:characteristic.


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

public class Characteristic : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

characteristic (Single Characteristic)

This element specifies a single characteristic. The type of characteristic is defined by the name attribute.

[Example: A producer can inform the consumer that the computations used to calculate the stored numbers in the formulas belong to a value space expressed by ranges of the binary mantissa and exponent. A consumer can optionally check those characteristics to determine whether, for example, the values should be recalculated. The XML for this would be:

  <characteristic name='precisionMantissa' relation='gt' val='-9007199254740992'/>
  <characteristic name='precisionMantissa' relation='lt' val='9007199254740992'/>
  <characteristic name='precisionExponent' relation='ge' val='-1075'/>
  <characteristic name='precisionExponent' relation='le' val='970'/>

end example]

Parent Elements

additionalCharacteristics (§



name (Name of Characteristic)

Specifies the name of the characteristic. There are no constraints on the value of the name attribute, but each name shall be associated with a specific vocabulary via the vocabulary attribute.

The values defined by /IEC 29500 shall be associated with a null vocabulary value, and are as follows:

Name Value

Property Specified


Number of Columns supported by the spreadsheet producer.


Number of Rows supported by the spreadsheet producer.


Version of the function specification used


Allowed values of the mantissa of numbers within spreadsheet cells/formulas when expressed in base 2.


Allowed values of the exponent of numbers within spreadsheet cells/formulas when expressed in base 2.


Number of Workbook colors


Number of condition format conditions on a workbook cell


Number of level of sorting on a range or table


Number of items shown in the Auto-filter dropdown


Number of characters that can display in a cell


Number of characters per cell that Excel can print


Number of unique cell styles in a workbook (combinations of all cell formatting)


Length of formulas in characters


Number of levels of formula nesting


Number of arguments to a function


Number of rows in a pivot table


Number of columns in a pivot table


Number of unique items in a pivot field


Number of characters in a MDX name for a pivot table item


String length for a relationship pivot table


Length of field labels in PivotTable including caption length limitations


Number of fields in a pivot table


The number of array formulas in a worksheet that can refer to another (given) worksheet

The possible values for this attribute are defined by the W3C XML Schema string datatype.

relation (Relationship of Value to Name)

Specifies how the contents of the value attribute should be interpreted in the context of this characteristic.

[Example: The following would specify that the application supports from 0 to 10,000 columns, and that column ranges should be interpreted accordingly:

  <characteristic name="numColumns" relation="le" val="10000"/>
  <characteristic name="numColumns" relation="ge" val="0"/>

end example]

The possible values for this attribute are defined by the ST_Relation simple type (§

val (Characteristic Value)

Specifies the value of the characteristic.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

vocabulary (Characteristic Grammar)

Specifies a defining the characteristic grammar with which the name attribute value shall be interpreted.

If this attribute is omitted, then the default grammar (as defined above) shall be used.

The possible values for this attribute are defined by the W3C XML Schema anyURI datatype.

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

© ISO/IEC29500: 2008.

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