DataValidation 类 
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
数据验证。
此类在 Office 2007 及更高版本中提供。
当对象序列化为 xml 时,其限定名称为 x:dataValidation。
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.ExcelAc.List), DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula1))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula2))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "dataValidation")]
public class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElementpublic class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr(22, "dataValidation")]
public class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:dataValidation")]
public class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:dataValidation")]
public class DataValidation : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.ExcelAc.List), DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula1))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula2))]
public class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.ExcelAc.List), DocumentFormat.OpenXml.FileFormatVersions.Office2013)]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula1))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula2))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.ExcelAc.List), DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula1))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula2))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "dataValidation")>]
type DataValidation = class
    inherit OpenXmlCompositeElementtype DataValidation = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr(22, "dataValidation")>]
type DataValidation = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:dataValidation")>]
type DataValidation = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:dataValidation")>]
type DataValidation = class
    inherit TypedOpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.ExcelAc.List), DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula1))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula2))>]
type DataValidation = class
    inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Office2010.ExcelAc.List), DocumentFormat.OpenXml.FileFormatVersions.Office2013)>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula1))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Formula2))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type DataValidation = class
    inherit OpenXmlCompositeElementPublic Class DataValidation
Inherits OpenXmlCompositeElementPublic Class DataValidation
Inherits TypedOpenXmlCompositeElement- 继承
- 继承
- 属性
注解
[ISO/IEC 29500-1 第 1 版]
dataValidation (数据验证)
工作表区域中定义的单个数据验证项。
| 父元素 | 
|---|
| dataValidations (§18.3.1.33) | 
| 子元素 | 第 | 
|---|---|
| formula1 (Formula 1) | §18.3.1.44 | 
| formula2 (Formula 2) | §18.3.1.45 | 
| 属性 | 说明 | 
|---|---|
| allowBlank (允许空白) | 一个布尔值,指示数据验证是允许使用空条目还是空条目。 “1”表示空条目正常,并且不违反验证约束。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。 | 
| 错误 (错误消息) | 错误警报的消息文本。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。 | 
| errorStyle (数据验证错误样式) | 用于此数据验证的错误警报样式。 此属性的可能值由 ST_DataValidationErrorStyle 简单类型 (§18.18.18) 定义。 | 
| errorTitle (错误警报文本) | 错误警报的标题栏文本。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。 | 
| imeMode (强制实施 IME 模式) | IME (输入法编辑器) 此数据验证强制实施模式。 仅适用于以下语言: -简体中文 -繁体中文 -日语 -朝鲜语 - 设置 imeMode 时,单元格的输入可以限制为由 imeMode 值指定的特定字符集。 有关更多详细信息,请参阅下面引用的简单类型。 如果设置了 imeMode,但应用程序的语言不是上面列出的语言之一,则默认值为 noControl。 此属性的可能值由 ST_DataValidationImeMode 简单类型 (§18.18.19) 定义。 | 
| 运算符 (运算符) | 用于此数据验证的关系运算符。 此属性的可能值由 ST_DataValidationOperator 简单类型 (§18.18.20) 定义。 | 
| prompt (输入提示) | 输入提示的消息文本。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。 | 
| promptTitle (提示标题) | 输入提示的标题栏文本。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。 | 
| showDropDown (显示下拉列表) | 一个布尔值,指示是否显示列表类型数据验证的下拉组合框。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。 | 
| showErrorMessage (显示错误消息) | 一个布尔值,指示根据指定的条件输入无效值时是否显示错误警报消息。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。 | 
| showInputMessage (显示输入消息) | 一个布尔值,指示是否显示输入提示消息。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。 | 
| sqref (引用序列) | 应用数据验证的范围。 此属性的可能值由 ST_Sqref 简单类型 (§18.18.76) 定义。 | 
| 类型 (数据验证类型) | 数据验证的类型。 此属性的可能值由 ST_DataValidationType 简单类型 (§18.18.21) 定义。 | 
[注意:此元素的内容模型 (CT_DataValidation) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]
ISO/IEC29500:2008。
构造函数
| DataValidation() | 初始化 DataValidation 类的新实例。 | 
| DataValidation(IEnumerable<OpenXmlElement>) | 使用指定的子元素初始化 DataValidation 类的新实例。 | 
| DataValidation(OpenXmlElement[]) | 使用指定的子元素初始化 DataValidation 类的新实例。 | 
| DataValidation(String) | 从外部 XML 初始化 DataValidation 类的新实例。 | 
属性
| AllowBlank | allowBlank 表示架构中的以下属性:allowBlank | 
| ChildElements | 获取当前元素的所有子节点。(继承自 OpenXmlElement) | 
| Error | error 表示架构中的以下属性:error | 
| ErrorStyle | errorStyle 表示架构中的以下属性:errorStyle | 
| ErrorTitle | errorTitle 表示架构中的以下属性:errorTitle | 
| ExtendedAttributes | 获取当前元素的架构) 中未定义的所有扩展属性 (属性。(继承自 OpenXmlElement) | 
| Features | IFeatureCollection获取当前元素的 。 此功能集合将是只读的,但会从其父部件和包继承功能(如果可用)。(继承自 OpenXmlElement) | 
| FirstChild | 获取当前 OpenXmlElement 元素的第一个子元素。(继承自 OpenXmlCompositeElement) | 
| Formula1 | Formula1。 表示架构中的以下元素标记:x:formula1。 | 
| Formula2 | Formula2。 表示架构中的以下元素标记:x:formula2。 | 
| HasAttributes | 获取一个值,该值指示当前元素是否具有任何属性。(继承自 OpenXmlElement) | 
| HasChildren | 获取一个值,该值指示当前元素是否具有任何子元素。(继承自 OpenXmlCompositeElement) | 
| ImeMode | imeMode 表示架构中的以下属性:imeMode | 
| InnerText | 获取或设置当前节点及其所有子节点的串联值。(继承自 OpenXmlCompositeElement) | 
| InnerXml | 获取或设置仅表示当前节点的子节点的标记。(继承自 OpenXmlCompositeElement) | 
| LastChild | 获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素,则返回 null (Visual Basic) Nothing。(继承自 OpenXmlCompositeElement) | 
| List | 列表中,此属性仅在 Office 2013 及更高版本中可用。 表示架构中的以下元素标记:x12ac:list。 | 
| LocalName | 数据验证。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时,其限定名称为 x:dataValidation。 | 
| LocalName | 获取当前元素的本地名称。(继承自 OpenXmlElement) | 
| MCAttributes | 获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性,则返回 null。(继承自 OpenXmlElement) | 
| NamespaceDeclarations | 获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明,则返回空枚举器。(继承自 OpenXmlElement) | 
| NamespaceUri | 获取当前元素的命名空间 URI。(继承自 OpenXmlElement) | 
| OpenXmlElementContext | 获取当前元素的 OpenXmlElementContext。(继承自 OpenXmlElement) | 
| Operator | operator 表示架构中的以下属性: 运算符 | 
| OuterXml | 获取表示当前元素及其所有子元素的标记。(继承自 OpenXmlElement) | 
| Parent | 获取当前元素的父元素。(继承自 OpenXmlElement) | 
| Prefix | 获取当前元素的命名空间前缀。(继承自 OpenXmlElement) | 
| Prompt | 提示 表示架构中的以下属性:prompt | 
| PromptTitle | promptTitle 表示架构中的以下属性:promptTitle | 
| SequenceOfReferences | sqref 表示架构中的以下属性:sqref | 
| ShowDropDown | showDropDown 表示架构中的以下属性:showDropDown | 
| ShowErrorMessage | showErrorMessage 表示架构中的以下属性:showErrorMessage | 
| ShowInputMessage | showInputMessage 表示架构中的以下属性:showInputMessage | 
| Type | type 表示架构中的以下属性:类型 | 
| 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() | 数据验证。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时,其限定名称为 x:dataValidation。(继承自 OpenXmlElement) | 
| IEnumerable<OpenXmlElement>.GetEnumerator() | 返回循环访问子集合的枚举器。(继承自 OpenXmlElement) |