DataValidations 类 
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义 DataValidations 类。
此类在 Office 2007 及更高版本中提供。
当对象序列化为 xml 时,其限定名称为 x:dataValidations。
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataValidation))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "dataValidations")]
public class DataValidations : DocumentFormat.OpenXml.OpenXmlCompositeElementpublic class DataValidations : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr(22, "dataValidations")]
public class DataValidations : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:dataValidations")]
public class DataValidations : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:dataValidations")]
public class DataValidations : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataValidation))]
public class DataValidations : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataValidation))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class DataValidations : DocumentFormat.OpenXml.OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataValidation))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "dataValidations")>]
type DataValidations = class
    inherit OpenXmlCompositeElementtype DataValidations = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr(22, "dataValidations")>]
type DataValidations = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:dataValidations")>]
type DataValidations = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:dataValidations")>]
type DataValidations = class
    inherit TypedOpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataValidation))>]
type DataValidations = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataValidation))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type DataValidations = class
    inherit OpenXmlCompositeElementPublic Class DataValidations
Inherits OpenXmlCompositeElementPublic Class DataValidations
Inherits TypedOpenXmlCompositeElement- 继承
- 继承
- 属性
注解
[ISO/IEC 29500-1 第 1 版]
dataValidations (数据验证)
此集合表示工作表中已应用数据验证功能的单元格的所有数据验证信息。
数据验证用于指定可输入到单元格中的数据的约束。 可以提供其他 UI 来帮助用户 (选择值,例如,单元格) 处于活动状态时,单元格上的下拉列表控件或悬停文本,以及帮助用户了解为何禁止特定条目 (例如警报和消息) 。
可以选择各种数据类型,并使用逻辑运算符 (例如大于、小于、等于等) 。 此外,可以使用单元格或区域引用,而不是指定允许的显式值集。
可以指定输入消息以帮助用户了解预期的值类型,并可以指定警告消息 (和警告类型) ,以在用户输入数据时发出警报,而数据根据工作表中指定的数据验证是不允许的。
[示例:
<dataValidations count="1">  
  <dataValidation type="whole" errorStyle="warning" operator="greaterThan"    showInputMessage="1" showErrorMessage="1" errorTitle="Invalid Data"     error="The value must be a whole number greater than 0."     promptTitle="Whole Number"     prompt="Please enter a whole number greater than 0." sqref="A1">  
    <formula1>0</formula1>  
  </dataValidation>  
</dataValidations>  
示例结束]
| 父元素 | 
|---|
| worksheet (§18.3.1.99) | 
| 子元素 | 第 | 
|---|---|
| dataValidation (数据验证) | §18.3.1.32 | 
| 属性 | 说明 | 
|---|---|
| 计数 (数据验证项计数) | 此工作表的预期数据验证项数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。 | 
| disablePrompts (Disable 提示) | 一个布尔值,指示是否禁用工作表的所有输入提示。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。 | 
| xWindow (左上角 (X 协) ) | 相对于数据验证输入左上角窗口) 的 x 坐标 ( (文本框) 。 这是每个工作表,而不是每个单元格。 单位(以像素为单位)。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。 | 
| yWindow (左上角 (Y 坐标) ) | y 坐标 (相对于数据验证输入提示左上角的窗口) )  (文本框。 这是每个工作表,而不是每个单元格。 单位(以像素为单位)。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。 | 
[注意:此元素的内容模型 (CT_DataValidations) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]
ISO/IEC29500:2008。
构造函数
| DataValidations() | 初始化 DataValidations 类的新实例。 | 
| DataValidations(IEnumerable<OpenXmlElement>) | 使用指定的子元素初始化 DataValidations 类的新实例。 | 
| DataValidations(OpenXmlElement[]) | 使用指定的子元素初始化 DataValidations 类的新实例。 | 
| DataValidations(String) | 从外部 XML 初始化 DataValidations 类的新实例。 | 
属性
| ChildElements | 获取当前元素的所有子节点。(继承自 OpenXmlElement) | 
| Count | 数据验证项计数 表示架构中的以下属性:count | 
| DisablePrompts | 禁用提示 表示架构中的以下属性:disablePrompts | 
| ExtendedAttributes | 获取当前元素的架构) 中未定义的所有扩展属性 (属性。(继承自 OpenXmlElement) | 
| Features | IFeatureCollection获取当前元素的 。 此功能集合将是只读的,但会从其父部件和包继承功能(如果可用)。(继承自 OpenXmlElement) | 
| FirstChild | 获取当前 OpenXmlElement 元素的第一个子元素。(继承自 OpenXmlCompositeElement) | 
| HasAttributes | 获取一个值,该值指示当前元素是否具有任何属性。(继承自 OpenXmlElement) | 
| HasChildren | 获取一个值,该值指示当前元素是否具有任何子元素。(继承自 OpenXmlCompositeElement) | 
| InnerText | 获取或设置当前节点及其所有子节点的串联值。(继承自 OpenXmlCompositeElement) | 
| InnerXml | 获取或设置仅表示当前节点的子节点的标记。(继承自 OpenXmlCompositeElement) | 
| LastChild | 获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。(继承自 OpenXmlCompositeElement) | 
| LocalName | 定义 DataValidations 类。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时,其限定名称为 x:dataValidations。 | 
| LocalName | 获取当前元素的本地名称。(继承自 OpenXmlElement) | 
| MCAttributes | 获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性,则返回 null。(继承自 OpenXmlElement) | 
| NamespaceDeclarations | 获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明,则返回空枚举器。(继承自 OpenXmlElement) | 
| NamespaceUri | 获取当前元素的命名空间 URI。(继承自 OpenXmlElement) | 
| OpenXmlElementContext | 获取当前元素的 OpenXmlElementContext。(继承自 OpenXmlElement) | 
| OuterXml | 获取表示当前元素及其所有子元素的标记。(继承自 OpenXmlElement) | 
| Parent | 获取当前元素的父元素。(继承自 OpenXmlElement) | 
| Prefix | 获取当前元素的命名空间前缀。(继承自 OpenXmlElement) | 
| XmlQualifiedName | 获取当前元素的限定名称。(继承自 OpenXmlElement) | 
| XName | 获取当前元素的限定名称。(继承自 OpenXmlElement) | 
| XWindow | 左上角 (X 坐标) 表示架构中的以下属性:xWindow | 
| YWindow | 左上角 (Y 坐标) 表示架构中的以下属性:yWindow | 
方法
| 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() | 定义 DataValidations 类。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时,其限定名称为 x:dataValidations。(继承自 OpenXmlElement) | 
| IEnumerable<OpenXmlElement>.GetEnumerator() | 返回循环访问子集合的枚举器。(继承自 OpenXmlElement) |