ErrorItem Class

Error Value.When the object is serialized out as xml, its qualified name is x:e.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Spreadsheet.ErrorItem

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(Tuples))> _
<ChildElementInfoAttribute(GetType(MemberPropertyIndex))> _
Public Class ErrorItem _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As ErrorItem
[ChildElementInfoAttribute(typeof(Tuples))]
[ChildElementInfoAttribute(typeof(MemberPropertyIndex))]
public class ErrorItem : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • Tuples <x:tpls>

  • MemberPropertyIndex <x:x>

[ISO/IEC 29500-1 1st Edition]

18.10.1.27 e (Error Value)

Represents an error value. The use of this item indicates that an error value is present in the PivotTable source. The error is recorded in the value attribute.

Parent Elements

entries (§18.10.1.28); groupItems (§18.10.1.38); r (§18.10.1.77); sharedItems (§18.10.1.90)

Child Elements

Subclause

tpls (Tuples)

§18.10.1.93

x (Member Property Index)

§18.10.1.96

Attributes

Description

b (Bold)

Specifies a boolean value that indicates whether the value contains bold formatting on the OLAP server. This attribute applies to OLAP-based PivotTables only.

A value of 1 or true indicates this value contains bold formatting on the server.

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

bc (background Color)

Specifies the background color for this value that was provided by the OLAP server. This attribute applies to OLAP-based PivotTables only. The color is specified as a HEX value in RGB space.

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

c (Item Caption)

Specifies the item/member caption

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

cp (Member Property Count)

Specifies the number of member property values.

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

f (Calculated Item)

Specifies a boolean value that indicates whether this is a calculated item value.

A value of 1 or true indicates value is a calculated item value.

A value of 0 or false indicates this value is not a calculated item value.

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

fc (Foreground Color)

Specifies the foreground color for this value that was provided by the OLAP server. This attribute applies to OLAP-based PivotTables only. The color is specified as a HEX value in RGB space.

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

i (Italic)

Specifies a boolean value that indicates whether the value contains italic formatting on the OLAP server. This attribute applies to OLAP-based PivotTables only.

A value of 1 or true indicates this value contains italic formatting on the server.

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

in (Format Index)

Specifies the index to the OLAP serverformat element where the format string for this entry is stored.

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

st (Strikethrough)

Specifies a boolean value that indicates whether the value contains strikethrough formatting on the OLAP server. This attribute applies to OLAP-based PivotTables only.

A value of 1 or true indicates this value contains strikethrough formatting on the server.

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

u (Unused Item)

Specifies a boolean value that indicates whether this is an unused item. The application marks an item as unused when an item is deleted from the data source. The item and associated metadata are retained in the cache until the threshold for unused items specified in missingItemsLimit is reached.

A value of 1 or true indicates this item is not used.

A value of 0 or false indicates this item is used.

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

un (Underline)

Specifies a boolean value that indicates whether the value contains underline formatting on the OLAP server. This attribute applies to OLAP-based PivotTables only.

A value of 1 or true indicates this value contains underline formatting on the server.

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

v (Value)

Specifies the value of the item. This attribute depends on how the application records errors.

[Note: While the error values are determined by the application, the following are some example error values that could be used:

  • #DIV/0!

  • #NAME?

  • #VALUE!

  • #NULL!

  • #NUM!

  • #REF!

  • #N/A

  • #GETTING_DATA

end note]

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

[Note: The W3C XML Schema definition of this element’s content model (CT_Error) is located in §A.2. 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

Reference

ErrorItem Members

DocumentFormat.OpenXml.Spreadsheet Namespace