DataValidation Класс

Определение

Пространство имен:

DocumentFormat.OpenXml.Office2010.Excel

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Определяет класс DataValidation.

Этот класс доступен в Office 2010 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — x14:dataValidation.

public class DataValidation : DocumentFormat.OpenXml.OpenXmlCompositeElement

type DataValidation = class
    inherit OpenXmlCompositeElement

Public Class DataValidation
Inherits OpenXmlCompositeElement

Наследование

Object

OpenXmlElement

OpenXmlCompositeElement

DataValidation

Комментарии

2.6.5 CT_DataValidation

Целевое пространство имен:http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

На который ссылается: CT_DataValidations

CT_DataValidation — это сложный тип, указывающий проверку данных для диапазона на этом листе.

Дочерние элементы:

formula1: Элемент CT_DataValidationFormula (раздел 2.6.4), указывающий первую формулу для проверки данных.

Если оператор имеет значение "between" или "notBetween", а тип не "custom", "list" или "none", эта формула используется в качестве меньшего из двух ограничивающих значений и ДОЛЖНА существовать.

Если оператор не является "between" или "notBetween", или тип имеет значение "custom", эта формула является единственной формулой и должна существовать.

Если оператор не является "between" или "notBetween", или типом "custom" или "list", либо формула является единственной формулой и ДОЛЖНА существовать, либо CT_DataValidation должен иметь список (раздел 2.4.42*) дочерний элемент.*

Если тип имеет значение none, эта формула НЕ ДОЛЖНА существовать.

formula2: Элемент CT_DataValidationFormula , указывающий вторую формулу для проверки данных.

Если оператор имеет значение "between" или "notBetween", а тип не имеет значения "custom", "list" или "none", эта формула используется как большее из двух ограничивающих значений и ДОЛЖНО существовать.

Если оператор не имеет значения "between" или "notBetween", или тип " custom", "list" или "none", эта формула НЕ ДОЛЖНА существовать.

xm:sqref: Элемент sqref (раздел 2.4.5), указывающий диапазоны, к которым применяется проверка данных.

Атрибуты:

Тип: Атрибут ST_DataValidationType ([ISO/IEC-29500-1] section 18.18.21), указывающий тип проверки данных.

errorStyle: Атрибут ST_DataValidationErrorStyle ([ISO/IEC-29500-1] section 18.18.18), указывающий стиль оповещения об ошибке, используемый для проверки данных.

imeMode: Атрибут ST_DataValidationImeMode ([ISO/IEC-29500-1] section 18.18.19), указывающий режим редактора метода ввода (IME), применяемый этой проверкой данных.

Оператор: Атрибут ST_DataValidationOperator ([ISO/IEC-29500-1] section 18.18.20), указывающий реляционный оператор, используемый при проверке данных. Если тип имеет значение "custom", "list" или "none", значение атрибута оператора не определено и должно игнорироваться.

allowBlank: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), который указывает, обрабатывает ли проверка данных пустые или пустые записи как допустимые.

showDropDown: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, следует ли отображать раскрывающееся поле со списком для проверки данных типа списка.

Значение showDropDown	Значение типа	Смысл
"true"	list	Отображает раскрывающееся поле со списком.
"false"	list	Подавляет раскрывающееся поле со списком.

showInputMessage: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, следует ли отображать входное сообщение с подсказкой.

showErrorMessage: Атрибут Boolean ([XMLSCHEMA2] section 3.2.2), указывающий, следует ли отображать оповещение об ошибке.

errorTitle: Атрибут ST_Xstring ([ISO/IEC-29500-1] section 22.9.2.19), указывающий текст строки заголовка оповещения об ошибке. Длина этой строки должна быть меньше или равна 32 символам.

Ошибка: Атрибут ST_Xstring , указывающий текст сообщения оповещения об ошибке. Длина этой строки должна быть меньше или равна 225 символам.

promptTitle: Атрибут ST_Xstring , указывающий текст строки заголовка запроса ввода. Длина этой строки должна быть меньше или равна 32 символам.

Строке: Атрибут ST_Xstring , указывающий текст сообщения в командной строке ввода. Эта строка должна быть меньше или равна 255 символам.

Следующий фрагмент xml-схемы W3C ([XMLSCHEMA1] раздел 2.1) указывает содержимое этого сложного типа.

<xsd:complexType name="CT_DataValidation">

<xsd:sequence>

<xsd:element name="formula1" type="CT_DataValidationFormula" minOccurs="0" maxOccurs="1"/>

<xsd:element name="formula2" type="CT_DataValidationFormula" minOccurs="0" maxOccurs="1"/>

<xsd:element ref="xm:sqref" minOccurs="1" maxOccurs="1"/>

</xsd:sequence>

<xsd:attribute name="type" type="x:ST_DataValidationType" use="optional" default="none"/>

<xsd:attribute name="errorStyle" type="x:ST_DataValidationErrorStyle" use="optional" default="stop"/>

<xsd:attribute name="imeMode" type="x:ST_DataValidationImeMode" use="optional" default="noControl"/>

<xsd:attribute name="operator" type="x:ST_DataValidationOperator" use="optional" default="between"/>

<xsd:attribute name="allowBlank" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="showDropDown" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="showInputMessage" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="showErrorMessage" type="xsd:boolean" use="optional" default="false"/>

<xsd:attribute name="errorTitle" type="x:ST_Xstring" use="optional"/>

<xsd:attribute name="error" type="x:ST_Xstring" use="optional"/>

<xsd:attribute name="promptTitle" type="x:ST_Xstring" use="optional"/>

<xsd:attribute name="prompt" type="x:ST_Xstring" use="optional"/>

</xsd:complexType>

Полная схема XML W3C см. в разделе 5.4 ([XMLSCHEMA1] раздел 2.1).

Конструкторы

DataValidation()	Инициализирует новый экземпляр класса DataValidation.
DataValidation(IEnumerable<OpenXmlElement>)	Инициализирует новый экземпляр класса DataValidation с указанными дочерними элементами.
DataValidation(OpenXmlElement[])	Инициализирует новый экземпляр класса DataValidation с указанными дочерними элементами.
DataValidation(String)	Инициализирует новый экземпляр класса DataValidation из внешнего XML-кода.

Свойства

AllowBlank	allowBlank, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: allowBlank
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
DataValidationForumla1	DataValidationForumla1. Представляет следующий тег элемента в схеме: x14:formula1.
DataValidationForumla2	DataValidationForumla2. Представляет следующий тег элемента в схеме: x14:formula2.
Error	ошибка. Это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: error
ErrorStyle	errorStyle, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: errorStyle
ErrorTitle	errorTitle, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: errorTitle
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
ImeMode	imeMode, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: imeMode
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
Operator	оператор, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: оператор
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
Prompt	это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: prompt
PromptTitle	promptTitle, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: promptTitle
ReferenceSequence	ReferenceSequence. Представляет следующий тег элемента в схеме: xne:sqref.
ShowDropDown	showDropDown, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: showDropDown
ShowErrorMessage	showErrorMessage, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: showErrorMessage
ShowInputMessage	showInputMessage, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: showInputMessage
Type	type, это свойство доступно только в Office 2010 и более поздних версиях. Представляет следующий атрибут в схеме: 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)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от 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. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от 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()	Определяет класс DataValidation. Этот класс доступен в Office 2010 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — x14:dataValidation. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)