DataBar 类

定义

命名空间:

DocumentFormat.OpenXml.Office2010.Excel

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义 DataBar 类。

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

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

public class DataBar : DocumentFormat.OpenXml.OpenXmlCompositeElement

type DataBar = class
    inherit OpenXmlCompositeElement

Public Class DataBar
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

DataBar

注解

2.6.30 CT_DataBar

目标命名空间：http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

引用者： CT_CfRule

一种复杂类型，指定在条件格式中使用的数据条。

子元素：

cfvo：CT_Cfvo 元素 (第 2.6.26 节) ，指定对应于数据条的最小/最大长度的单元格值。 如果存在CT_Cfvo ([ISO/IEC-29500-4]节 A.2) 元素，则本表中 (1 个) 元素是CT_DataBar ([ISO/IEC-29500-4] 节 A.2) 元素，该元素是CT_CfRule ( 的子元素/IEC-29500-4] A.2) 元素，该元素是CT_ExtensionList ([ISO/IEC-29500-4] 部分 A.2) 元素的子CT_Extension ([ISO/IEC-29500-4] 部分 A.2) 元素具有子ST_Guid ([ISO/IEC-29500-4] 节 A.2) 元素等于此复杂类型的父CT_CfRule元素的 id 属性 (第 2.6.27 节) ，应忽略那些CT_Cfvo元素<49>。 第一 个子CT_Cfvo 元素指定与数据条的最小长度相对应的 条件 。 第二 个子CT_Cfvo 元素指定对应于数据条的最大长度的条件。

fillColor：CT_Color ([ISO/IEC-29500-4] 节 A.2) 元素，用于指定数据条的填充颜色。 仅当属于此复杂类型的父级的CT_CfRule的 priority 属性存在时，此元素必须存在。

borderColor： 一个 CT_Color 元素，用于指定数据条的边框颜色。 当且仅 当边框 等于“true”时，此元素必须存在。

negativeFillColor： 指定数据条的负填充颜色的 CT_Color 元素。 仅当 negativeBarColorSameAsPositive 等于“false”时，此元素必须存在。

negativeBorderColor：一个 CT_Color 元素，用于指定数据条的负边框颜色。 仅当 negativeBarBorderColorSameAsPositive 等于“false”且 边框 等于“true”时，此元素必须存在。

axisColor： 一个 CT_Color 元素，用于指定数据条的轴颜色。 当且仅当 axisPosition 不等于“none”时，此元素必须存在。

属性：

minLength：unsignedInt ([XMLSCHEMA2] 第 3.3.22 节) 属性，该属性指定此条件格式范围内的最短数据条的长度，以包含数据条的单元格宽度的百分比表示。 必须大于或等于零且小于或等于 maxLength。 如果同一工作表部件中存在CT_ExtensionList元素，该元素是CT_CfRule的后代，子CT_Extension元素的子ST_Guid元素等于作为此元素的父级CT_CfRule元素的 id 属性，并且此元素的 minLength 属性为零 (“0”) 且此元素的 maxLength 属性为“100”， CT_DataBar 元素的 minLength 属性，该元素是CT_CfRule 元素的后代，该元素是CT_Extension 元素的父元素的父级CT_ExtensionList元素的父元素，子ST_Guid元素等于作为此元素的父元素 CT_CfRule的 id 属性必须为“10”。 如果同一工作表部件中存在一个CT_ExtensionList元素，该元素是CT_CfRule的后代CT_Extension元素的子ST_Guid元素等于作为此元素的父元素 CT_CfRule的 id 属性，并且此元素的 minLength 属性不是零 (“0”) 或此元素的 maxLength 属性不是“100”， CT_DataBar 元素的 minLength 属性，该元素是CT_CfRule 元素的后代，该元素是CT_ExtensionList 元素的父元素，该元素是CT_Extension 元素的父元素的父元素，子ST_Guid 元素等于作为此元素的父元素 CT_CfRule的 id 属性必须等于此复杂类型的 minLength。

maxLength：一个 unsignedInt 属性，指定此条件格式设置范围中最长数据条的长度，以所设置格式的单元格宽度的百分比表示。 必须大于或等于 minLength 且小于或等于 100。 如果同一工作表部件中存在一个CT_ExtensionList元素，该元素是 CT_CfRule子CT_Extension元素的子CT_Extension元素的后代 ST_Guid CT_CfRule元素的id 属性，而此元素的 minLength 属性为零， (“0”) 且此元素的 maxLength 属性为“100”， CT_DataBar 元素的 maxLength 属性是CT_CfRule 元素的后代，该元素是CT_ExtensionList 元素的父元素，该元素是CT_Extension 元素的父元素的父元素，子ST_Guid元素的 id 属性等于作为此元素的父元素 CT_CfRule的 id 属性必须为“90”。 如果同一工作表部件中存在CT_ExtensionList元素，该元素是CT_CfRule的后代，子CT_Extension元素的子ST_Guid元素等于作为此元素的父级CT_CfRule元素的 id 属性，并且此元素的 minLength 属性不是零 (“0”) 或此元素的 maxLength 属性不是“100”， CT_DataBar 元素的 maxLength 属性，该属性是CT_CfRule 元素的后代，该元素是CT_ExtensionList 元素的父元素，该元素是CT_Extension 元素的父元素的父元素，其子ST_Guid 元素等于此元素 CT_CfRule的 id 属性，该元素是此元素的父元素的 id 属性必须等于此记录的 maxLength。

showValue：布尔 ([XMLSCHEMA2] 第 3.2.2 节) 属性，该属性指定条件格式范围内的单元格是同时显示数据条和数值，还是仅显示数据条。 下表描述了其可能的值。

值	含义
“false”	单元格中仅显示数据栏。
“true”	数据条和数值都显示在单元格中。

边境：布尔 ([XMLSCHEMA2] 第 3.2.2 节) 属性，该属性指定数据栏是否具有边框。

梯度：布尔 ([XMLSCHEMA2] 第 3.2.2 节) 属性，该属性指定数据条是否具有渐变填充。 下表描述了其可能的值。

值	含义
“false”	数据条填充是纯色。
“true”	数据条填充是渐变。

方向：ST_DataBarDirection 属性部分 2.7.7) ，用于指定数据条的方向。

negativeBarColorSameAsPositive：布尔 ([XMLSCHEMA2] 第 3.2.2 节) 属性，该属性指定数据条是否具有与正条颜色不同的负条形图颜色。

negativeBarBorderColorSameAsPositive：布尔 ([XMLSCHEMA2] 第 3.2.2 节) 属性，该属性指定数据条是否具有不同于正边框颜色的负边框颜色。

axisPosition：ST_DataBarAxisPosition属性 (2.7.8) 部分指定数据条的轴位置。

以下 W3C XML 架构 ([XMLSCHEMA1] 部分 2.1) 片段指定此复杂类型的内容。

<xsd：complexType name=“CT_DataBar”>

<xsd：sequence>

<xsd：element name=“cfvo” type=“CT_Cfvo” minOccurs=“2” maxOccurs=“2”/>

<xsd：element name=“fillColor” type=“x：CT_Color” minOccurs=“0” maxOccurs=“1”/>

<xsd：element name=“borderColor” type=“x：CT_Color” minOccurs=“0” maxOccurs=“1”/>

<xsd：element name=“negativeFillColor” type=“x：CT_Color” minOccurs=“0” maxOccurs=“1”/>

<xsd：element name=“negativeBorderColor” type=“x：CT_Color” minOccurs=“0” maxOccurs=“1”/>

<xsd：element name=“axisColor” type=“x：CT_Color” minOccurs=“0” maxOccurs=“1”/>

</xsd：sequence>

<xsd：attribute name=“minLength” type=“xsd：unsignedInt” use=“optional” default=“10”/>

<xsd：attribute name=“maxLength” type=“xsd：unsignedInt” use=“optional” default=“90”/>

<xsd：attribute name=“showValue” type=“xsd：boolean” use=“optional” default=“true”/>

<xsd：attribute name=“border” type=“xsd：boolean” use=“optional” default=“false”/>

<xsd：attribute name=“gradient” type=“xsd：boolean” use=“optional” default=“true”/>

<xsd：attribute name=“direction” type=“ST_DataBarDirection” use=“optional” default=“context”/>

<xsd：attribute name=“negativeBarColorSameAsPositive” type=“xsd：boolean” use=“optional” default=“false”/>

<xsd：attribute name=“negativeBarBorderColorSameAsPositive” type=“xsd：boolean” use=“optional” default=“true”/>

<xsd：attribute name=“axisPosition” type=“ST_DataBarAxisPosition” use=“optional” default=“automatic”/>

</xsd：complexType>

有关完整的 W3C XML 架构 ([XMLSCHEMA1] 部分 2.1) ，请参阅第 5.4 节。

构造函数

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

属性

AxisPosition	axisPosition， 此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：axisPosition
Border	border，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：border
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Direction	方向，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性： 方向
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
Gradient	gradient，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：渐变
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MaxLength	maxLength，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：maxLength
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
MinLength	minLength，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：minLength
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
NegativeBarBorderColorSameAsPositive	negativeBarBorderColorSameAsPositive，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：negativeBarBorderColorSameAsPositive
NegativeBarColorSameAsPositive	negativeBarColorSameAsPositive，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：negativeBarColorSameAsPositive
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
ShowValue	showValue，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：showValue
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()	定义 DataBar 类。 此类在 Office 2010 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 x14：dataBar。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)