Compartilhar via


DataValidation Classe

Definição

Validação de dados.

Essa classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é 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.OpenXmlCompositeElement
public 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 OpenXmlCompositeElement
type 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 OpenXmlCompositeElement
Public Class DataValidation
Inherits OpenXmlCompositeElement
Public Class DataValidation
Inherits TypedOpenXmlCompositeElement
Herança
Herança
Atributos

Comentários

[ISO/IEC 29500-1 1st Edition]

dataValidation (Validação de Dados)

Um único item de validação de dados definido em um intervalo da planilha.

Elementos pai
dataValidations (§18.3.1.33)
Elementos filho Subclause
formula1 (Fórmula 1) §18.3.1.44
formula2 (Fórmula 2) §18.3.1.45
Atributos Descrição
allowBlank (Permitir em branco) Um valor booliano que indica se a validação de dados permite o uso de entradas vazias ou em branco. '1' significa que as entradas vazias são OK e não violam as restrições de validação.

Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
erro (Mensagem de Erro) Texto da mensagem de alerta de erro.

Os valores possíveis para esse atributo são definidos pelo tipo ST_Xstring simples (§22.9.2.19).
errorStyle (Estilo de erro de validação de dados) O estilo de alerta de erro usado para essa validação de dados.

Os valores possíveis para esse atributo são definidos pelo tipo ST_DataValidationErrorStyle simples (§18.18.18).
errorTitle (Texto de Alerta de Erro) Texto da barra de título do alerta de erro.

Os valores possíveis para esse atributo são definidos pelo tipo ST_Xstring simples (§22.9.2.19).
imeMode (modo IME imposto) O modo IME (editor de método de entrada) imposto por essa validação de dados. Aplica-se apenas a esses idiomas:

-Chinês simplificado
-Chinês tradicional
-Japonês
-Coreano
- Quando imeMode é definido, a entrada para a célula pode ser restrita a conjuntos específicos de caracteres, conforme especificado pelo valor de imeMode. Consulte o tipo simples referenciado abaixo para obter detalhes adicionais.

Quando imeMode é definido, mas o idioma do aplicativo não é um dos idiomas listados acima, o valor padrão não éControl.

Os valores possíveis para esse atributo são definidos pelo tipo ST_DataValidationImeMode simples (§18.18.19).
operador (Operador) O operador relacional usado com essa validação de dados.

Os valores possíveis para esse atributo são definidos pelo tipo ST_DataValidationOperator simples (§18.18.20).
prompt (Prompt de Entrada) Texto da mensagem do prompt de entrada.

Os valores possíveis para esse atributo são definidos pelo tipo ST_Xstring simples (§22.9.2.19).
promptTitle (Título do Prompt) Texto da barra de título do prompt de entrada.

Os valores possíveis para esse atributo são definidos pelo tipo ST_Xstring simples (§22.9.2.19).
showDropDown (Mostrar Drop Down) Um valor booliano que indica se deve exibir uma caixa de combinação suspensa para uma validação de dados de tipo de lista.

Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
showErrorMessage (mostrar mensagem de erro) Um valor booliano que indica se deve exibir a mensagem de alerta de erro quando um valor inválido foi inserido, de acordo com os critérios especificados.

Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
showInputMessage (mostrar mensagem de entrada) Um valor booliano que indica se deve exibir a mensagem de prompt de entrada.

Os valores possíveis para esse atributo são definidos pelo tipo de dados booliano W3C XML Schema.
sqref (sequência de referências) Intervalo sobre qual validação de dados é aplicada.

Os valores possíveis para esse atributo são definidos pelo tipo ST_Sqref simples (§18.18.76).
tipo (Tipo de Validação de Dados) O tipo de validação de dados.

Os valores possíveis para esse atributo são definidos pelo tipo ST_DataValidationType simples (§18.18.21).

[Observação: a definição de esquema XML W3C do modelo de conteúdo desse elemento (CT_DataValidation) está localizada em §A.2. nota final]

ISO/IEC29500: 2008.

Construtores

DataValidation()

Inicializa uma nova instância da classe DataValidation.

DataValidation(IEnumerable<OpenXmlElement>)

Inicializa uma nova instância da classe DataValidation com os elementos filho especificados.

DataValidation(OpenXmlElement[])

Inicializa uma nova instância da classe DataValidation com os elementos filho especificados.

DataValidation(String)

Inicializa uma nova instância da classe DataValidation do XML externo.

Propriedades

AllowBlank

Allowblank

Representa o seguinte atributo no esquema: allowBlank

ChildElements

Obtém todos os nós filho do elemento atual.

(Herdado de OpenXmlElement)
Error

erro

Representa o seguinte atributo no esquema: erro

ErrorStyle

Errorstyle

Representa o seguinte atributo no esquema: errorStyle

ErrorTitle

errorTitle

Representa o seguinte atributo no esquema: errorTitle

ExtendedAttributes

Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual.

(Herdado de OpenXmlElement)
Features

Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível.

(Herdado de OpenXmlElement)
FirstChild

Obtém o primeiro filho do elemento OpenXmlElement atual.

(Herdado de OpenXmlCompositeElement)
Formula1

Fórmula 1.

Representa a seguinte marca de elemento no esquema: x:formula1.

Formula2

Fórmula2.

Representa a seguinte marca de elemento no esquema: x:formula2.

HasAttributes

Obtém um valor que indica se o elemento atual tem atributos.

(Herdado de OpenXmlElement)
HasChildren

Obtém um valor que indica se o elemento atual tem elementos filho.

(Herdado de OpenXmlCompositeElement)
ImeMode

Imemode

Representa o seguinte atributo no esquema: imeMode

InnerText

Obtém ou define os valores concatenados do nó atual e de todos os seus filhos.

(Herdado de OpenXmlCompositeElement)
InnerXml

Obtém ou define a marcação que representa apenas os nós filho do nó atual.

(Herdado de OpenXmlCompositeElement)
LastChild

Obtém o último filho do elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver esse elemento OpenXmlElement.

(Herdado de OpenXmlCompositeElement)
List

List, essa propriedade só está disponível no Office 2013 e posterior..

Representa a seguinte marca de elemento no esquema: x12ac:list.

LocalName

Validação de dados.

Essa classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é x:dataValidation.

LocalName

Obtém o nome local do elemento atual.

(Herdado de OpenXmlElement)
MCAttributes

Obtém ou define os atributos de compatibilidade de marcação. Retorna nulo se nenhum atributo de compatibilidade de marcação for definido para o elemento atual.

(Herdado de OpenXmlElement)
NamespaceDeclarations

Obtém todas as declarações de namespace definidas no elemento atual. Retornará um enumerador vazio se não houver nenhuma declaração de namespace.

(Herdado de OpenXmlElement)
NamespaceUri

Obtém o URI do namespace do elemento atual.

(Herdado de OpenXmlElement)
OpenXmlElementContext

Obtém o OpenXmlElementContext do elemento atual.

(Herdado de OpenXmlElement)
Operator

operator

Representa o seguinte atributo no esquema: operador

OuterXml

Obtém a marcação que representa o elemento atual e todos os seus elementos filho.

(Herdado de OpenXmlElement)
Parent

Obtém o elemento pai do elemento atual.

(Herdado de OpenXmlElement)
Prefix

Obtém o prefixo namespace do elemento atual.

(Herdado de OpenXmlElement)
Prompt

prompt

Representa o seguinte atributo no esquema: prompt

PromptTitle

promptTitle

Representa o seguinte atributo no esquema: promptTitle

SequenceOfReferences

sqref

Representa o seguinte atributo no esquema: sqref

ShowDropDown

Showdropdown

Representa o seguinte atributo no esquema: showDropDown

ShowErrorMessage

showErrorMessage

Representa o seguinte atributo no esquema: showErrorMessage

ShowInputMessage

showInputMessage

Representa o seguinte atributo no esquema: showInputMessage

Type

type

Representa o seguinte atributo no esquema: tipo

XmlQualifiedName

Obtém o nome qualificado do elemento atual.

(Herdado de OpenXmlElement)
XName

Obtém o nome qualificado do elemento atual.

(Herdado de OpenXmlElement)

Métodos

AddAnnotation(Object)

Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)

Adiciona o elemento especificado ao elemento se ele for uma criança conhecida. Isso adiciona o elemento no local correto de acordo com o esquema.

(Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)

Adiciona uma declaração de namespace ao nó atual.

(Herdado de OpenXmlElement)
Ancestors()

Enumera todos os ancestrais do elemento atual.

(Herdado de OpenXmlElement)
Ancestors<T>()

Enumera apenas os ancestrais do elemento atual que têm o tipo especificado.

(Herdado de OpenXmlElement)
Annotation(Type)

Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
Annotation<T>()

Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
Annotations(Type)

Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
Annotations<T>()

Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)

Acrescenta cada elemento de uma lista de elementos ao final da lista de elementos filho do elemento atual.

(Herdado de OpenXmlElement)
Append(OpenXmlElement[])

Acrescenta cada elemento de uma matriz de elementos até o final da lista de elementos filho do elemento atual.

(Herdado de OpenXmlElement)
AppendChild<T>(T)

Acrescenta o elemento especificado ao final da lista de nós filho do elemento atual.

(Herdado de OpenXmlCompositeElement)
ClearAllAttributes()

Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos.

(Herdado de OpenXmlElement)
Clone()

Cria uma duplicata do nó atual.

(Herdado de OpenXmlElement)
CloneNode(Boolean)

Cria uma duplicata desse nó.

Descendants()

Enumera todos os descendentes do elemento atual.

(Herdado de OpenXmlElement)
Descendants<T>()

Enumera todos os descendentes do elemento atual do tipo T.

(Herdado de OpenXmlElement)
Elements()

Enumera todos os filhos do elemento atual.

(Herdado de OpenXmlElement)
Elements<T>()

Enumera apenas os filhos do elemento atual que têm o tipo especificado.

(Herdado de OpenXmlElement)
ElementsAfter()

Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual.

(Herdado de OpenXmlElement)
ElementsBefore()

Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual.

(Herdado de OpenXmlElement)
GetAttribute(String, String)

Obtém um atributo Open XML com o nome da marca e o URI do namespace especificados.

(Herdado de OpenXmlElement)
GetAttributes()

Obtém uma lista que contém uma cópia de todos os atributos.

(Herdado de OpenXmlElement)
GetEnumerator()

Retorna um enumerador que itera por meio da coleção filho.

(Herdado de OpenXmlElement)
GetFirstChild<T>()

Localiza o primeiro elemento filho no tipo T.

(Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)

Insere o elemento especificado imediatamente após o elemento de referência especificado.

(Herdado de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)

Insere o elemento especificado imediatamente após o elemento atual.

(Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)

Insere o elemento especificado no índice especificado dos filhos do elemento atual.

(Herdado de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)

Insere o elemento especificado imediatamente antes do elemento de referência especificado.

(Herdado de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)

Insere o elemento especificado imediatamente antes do elemento atual.

(Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)

Determina se o elemento atual é exibido após um elemento especificado na ordem do documento.

(Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)

Determina se o elemento atual é exibido antes de um elemento especificado na ordem do documento.

(Herdado de OpenXmlElement)
LookupNamespace(String)

Resolve o prefixo namespace no contexto do nó atual.

(Herdado de OpenXmlElement)
LookupPrefix(String)

Localiza o prefixo correspondente para um uri de namespace no escopo do elemento atual.

(Herdado de OpenXmlElement)
NextSibling()

Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement.

(Herdado de OpenXmlElement)
NextSibling<T>()

Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retornará nulo (Nada no Visual Basic) se não houver o próximo OpenXmlElement.

(Herdado de OpenXmlElement)
PrependChild<T>(T)

Insere o elemento especificado no início da lista de nós filho do elemento atual.

(Herdado de OpenXmlCompositeElement)
PreviousSibling()

Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (Nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior.

(Herdado de OpenXmlElement)
PreviousSibling<T>()

Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (Nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior.

(Herdado de OpenXmlElement)
Remove()

Remove o elemento atual de seu pai.

(Herdado de OpenXmlElement)
RemoveAllChildren()

Remove todos os elementos filho do elemento atual.

(Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()

Remova todos os elementos filho do elemento atual que são do tipo T.

(Herdado de OpenXmlElement)
RemoveAnnotations(Type)

Remove as anotações do tipo especificado do elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
RemoveAnnotations<T>()

Remove as anotações com o tipo especificado do elemento OpenXmlElement atual.

(Herdado de OpenXmlElement)
RemoveAttribute(String, String)

Remove o atributo do elemento atual.

(Herdado de OpenXmlElement)
RemoveChild<T>(T)

Remove o elemento filho especificado.

(Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)

Remove a declaração de namespace do prefixo especificado. Não removerá nada se não houver nenhum prefixo.

(Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)

Substitui um dos elementos filho do elemento atual por outro elemento OpenXmlElement.

(Herdado de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)

Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos.

(Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)

Define uma série de atributos para o elemento. Se um atributo for um atributo conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos.

(Herdado de OpenXmlElement)
WriteTo(XmlWriter)

Salva o nó atual no XmlWriter especificado.

(Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()

Validação de dados.

Essa classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é x:dataValidation.

(Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()

Retorna um enumerador que itera por meio da coleção filho.

(Herdado de OpenXmlElement)

Aplica-se a