SortCondition 类

定义

命名空间:

DocumentFormat.OpenXml.Office2010.Excel

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义 SortCondition 类。

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

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

public class SortCondition : DocumentFormat.OpenXml.OpenXmlLeafElement

type SortCondition = class
    inherit OpenXmlLeafElement

Public Class SortCondition
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

SortCondition

注解

2.4.32 sortCondition

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

sortCondition 元素是CT_SortCondition类型元素，如第 2.6.61 节中所述，它指定要应用于区域的排序条件。 请参阅第 2.2.4.4 节、第 2.2.4.6 节、第 2.2.4.9 节和第 2.2.4.11 节，了解此元素如何与 [ISO/IEC-29500-1] 中指定的 Office Open XML 文件格式集成。

以下 W3C XML 架构 ([XMLSCHEMA1] 部分 2.1) 片段指定此元素的内容。

<xsd：element name=“sortCondition” type=“CT_SortCondition”/>

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

2.6.61 CT_SortCondition

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

引用者： sortCondition

一个复杂类型，指定要应用于区域的排序条件。

属性：

降：布尔 ([XMLSCHEMA2] 第 3.2.2 节) 属性，用于指定排序方向。

值	含义
“false”	如果 sortBy 为“value”，则按升序排序。 如果 sortBy 为“cellColor”或“fontColor”，则单元格颜色或单元格字体颜色由 dxfId 指定的单元格位于区域的顶部。 如果 sortBy 为“icon”，则由 iconSet 和 iconId 指定的图标所在的单元格将位于区域顶部。
“true”	如果 sortBy 为“value”，则按降序排序。 如果 sortBy 为“cellColor”或“fontColor”，则出现 dxfId 指定的单元格颜色或单元格字体颜色的单元格位于区域底部。 如果 sortBy 为“icon”，则由 iconSet 和 iconId 指定的图标出现在单元格区域底部。

sortBy：ST_SortBy ([ISO/IEC-29500-1] 第 18.18.72 节) 属性，该属性指定区域中单元格的排序方式。

裁判：ST_Ref ([ISO/IEC-29500-1] 第 18.18.62 节) 属性，该属性指定此排序条件适用的行 (2) 或列 (2) 。 此值必须包含在此元素之前的 sortState 元素的 ref 中。 如果此元素前面的 sortState.columnSort 属性为“false”，则此值指定此排序条件适用的列 (2) ，并且只能有一列 (2) ref 指定的列。如果此元素前面的 sortState.columnSort 属性为“true”，则此值指定此排序条件所应用到的行 (2) ，并且只能有一行 (2) ref 指定的行。

customList：ST_Xstring ([ISO/IEC-29500-1] 第 22.9.2.19 节) 属性，该属性指定以逗号分隔的字符串列表，该列表指定自定义排序顺序 (2) 。 列表中的字符串顺序指定排序顺序 (2) 。 当单元格值与列表中的字符串匹配时，将先于与列表中的后续字符串匹配的单元格值排序，以此类方式对区域中的每个单元格进行排序。 如果 sortBy 不等于“value”，则必须忽略。

dxfId：ST_DxfId ([ISO/IEC-29500-1] 第 18.18.25 节) 属性，该属性指定 sortBy 等于“cellColor”或 sortBy 等于“fontColor”的格式标识符。 如果 sortBy 等于“icon”或“value”，则不能存在。

iconSet： 一个 ST_IconSetType 属性，该属性指定 sortBy 等于“icon”时设置的图标。 缺少此属性意味着没有图标。 如果 sortBy 不等于“icon”，则不能存在。

iconId：unsignedInt ([XMLSCHEMA2] 第 3.3.22 节) 属性，该属性指定图标集中图标的从零开始的索引。 如果 iconSet 指定的图标集具有三个图标，则此值必须小于或等于 2。 如果 iconSet 指定的图标 集有四个图标，则此值必须小于或等于 3。 如果 iconSet 指定的图标集具有五个图标，则此值必须小于或等于 4。 缺少此属性意味着没有图标。 如果 sortBy 不等于“icon”，则不能存在。

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

<xsd：complexType name=“CT_SortCondition”>

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

<xsd：attribute name=“sortBy” type=“x：ST_SortBy” use=“optional” default=“value”/>

<xsd：attribute name=“ref” type=“x：ST_Ref” use=“required”/>

<xsd：attribute name=“customList” type=“x：ST_Xstring” use=“optional”/>

<xsd：attribute name=“dxfId” type=“x：ST_DxfId” use=“optional”/>

<xsd：attribute name=“iconSet” type=“ST_IconSetType” use=“optional” default=“3Arrows”/>

<xsd：attribute name=“iconId” type=“xsd：unsignedInt” use=“optional”/>

</xsd：complexType>

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

构造函数

SortCondition()

初始化 SortCondition 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
CustomList	customList，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：customList
Descending	此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：降序
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
FormatId	dxfId，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：dxfId
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafElement)
IconId	iconId，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：iconId
IconSet	iconSet，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：iconSet
InnerText	获取或设置节点及其所有子级的串联值。 (继承自 OpenXmlElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafElement)
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
Reference	ref，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：ref
SortBy	sortBy，此属性仅在 Office 2010 及更高版本中可用。 表示架构中的以下属性：sortBy
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)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 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 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子元素列表的开头插入指定的元素。 (继承自 OpenXmlElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 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()	定义 SortCondition 类。 此类在 Office 2010 及更高版本中可用。 将对象序列化为 xml 时，其限定名称为 x14：sortCondition。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)