Compartilhar via


DataValidation Classe

Definição

Validação de Dados.

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

Quando o objeto é serializado como xml, o 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 num intervalo da folha de cálculo.

Elementos pai
dataValidations (}18.3.1.33)
Elementos filho Subclautilizar
fórmula1 (Fórmula 1) §18.3.1.44
fórmula2 (Fórmula 2) §18.3.1.45
Atributos Descrição
allowBlank (Permitir Em Branco) Um valor booleano que indica se a validação de dados permite a utilização de entradas vazias ou em branco. "1" significa que as entradas vazias estão ok e não violam as restrições de validação.

Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
erro (Mensagem de Erro) Texto da mensagem do alerta de erro.

Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
errorStyle (Estilo de Erro de Validação de Dados) O estilo do alerta de erro utilizado para esta validação de dados.

Os valores possíveis para este atributo são definidos pelo ST_DataValidationErrorStyle tipo 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 este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
imeMode (Modo IME Imposto) O modo IME (input method editor) imposto por esta validação de dados. Aplica-se apenas a estes idiomas:

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

Quando imeMode está definido, mas o idioma da aplicação não é um dos idiomas listados acima, o valor predefinido é noControl.

Os valores possíveis para este atributo são definidos pelo ST_DataValidationImeMode tipo simples (}18.18.19).
operador (Operador) O operador relacional utilizado com esta validação de dados.

Os valores possíveis para este atributo são definidos pelo ST_DataValidationOperator tipo simples (}18.18.20).
prompt (Pedido de Entrada) Texto da mensagem do pedido de entrada.

Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
promptTitle (Título da Linha de Comandos) Texto da barra de título do pedido de entrada.

Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
showDropDown (Mostrar Lista Pendente) Um valor booleano que indica se pretende apresentar uma caixa de combinação pendente para uma validação de dados de tipo de lista.

Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
showErrorMessage (Mostrar Mensagem de Erro) Um valor booleano que indica se pretende apresentar a mensagem de alerta de erro quando foi introduzido um valor inválido, de acordo com os critérios especificados.

Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
showInputMessage (Mostrar Mensagem de Entrada) Um valor booleano que indica se pretende apresentar a mensagem de pedido de entrada.

Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
sqref (Sequência de Referências) Intervalo sobre o qual a validação de dados é aplicada.

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

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

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_DataValidation) está localizada em {A.2. nota de fim]

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 subordinados especificados.

DataValidation(OpenXmlElement[])

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

DataValidation(String)

Inicializa uma nova instância da classe DataValidation a partir de XML externo.

Propriedades

AllowBlank

allowBlank

Representa o seguinte atributo no esquema: allowBlank

ChildElements

Obtém todos os nós subordinados 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 expandidos (atributos não definidos no esquema) do elemento atual.

(Herdado de OpenXmlElement)
Features

Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível.

(Herdado de OpenXmlElement)
FirstChild

Obtém o primeiro elemento subordinado do elemento OpenXmlElement atual.

(Herdado de OpenXmlCompositeElement)
Formula1

Fórmula1.

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

Formula2

Fórmula2.

Representa a seguinte etiqueta 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 subordinados.

(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 respetivos subordinados.

(Herdado de OpenXmlCompositeElement)
InnerXml

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

(Herdado de OpenXmlCompositeElement)
LastChild

Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement.

(Herdado de OpenXmlCompositeElement)
List

Lista: esta propriedade só está disponível no Office 2013 e posterior.

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

LocalName

Validação de Dados.

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

Quando o objeto é serializado como xml, o 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 markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual.

(Herdado de OpenXmlElement)
NamespaceDeclarations

Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes.

(Herdado de OpenXmlElement)
NamespaceUri

Obtém o URI do espaço de nomes do elemento atual.

(Herdado de OpenXmlElement)
OpenXmlElementContext

Obtém o OpenXmlElementContext do elemento atual.

(Herdado de OpenXmlElement)
Operator

operator

Representa o seguinte atributo no operador schema:

OuterXml

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

(Herdado de OpenXmlElement)
Parent

Obtém o elemento principal do elemento atual.

(Herdado de OpenXmlElement)
Prefix

Obtém o prefixo de espaço de nomes 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 for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema.

(Herdado de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)

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

(Herdado de OpenXmlElement)
Ancestors()

Enumera todos os predecessores do elemento atual.

(Herdado de OpenXmlElement)
Ancestors<T>()

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

(Herdado de OpenXmlElement)
Annotation(Type)

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

(Herdado de OpenXmlElement)
Annotation<T>()

Obtenha o primeiro objeto de anotação do tipo especificado a partir 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 fim da lista de elementos subordinados do elemento atual.

(Herdado de OpenXmlElement)
Append(OpenXmlElement[])

Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual.

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

Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual.

(Herdado de OpenXmlCompositeElement)
ClearAllAttributes()

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

(Herdado de OpenXmlElement)
Clone()

Cria um duplicado do nó atual.

(Herdado de OpenXmlElement)
CloneNode(Boolean)

Cria um duplicado deste nó.

Descendants()

Enumera todos os descendentes do elemento atual.

(Herdado de OpenXmlElement)
Descendants<T>()

Enumerar todos os descendentes do elemento atual do tipo T.

(Herdado de OpenXmlElement)
Elements()

Enumera todos os elementos subordinados do elemento atual.

(Herdado de OpenXmlElement)
Elements<T>()

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

(Herdado de OpenXmlElement)
ElementsAfter()

Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual.

(Herdado de OpenXmlElement)
ElementsBefore()

Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual.

(Herdado de OpenXmlElement)
GetAttribute(String, String)

Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes.

(Herdado de OpenXmlElement)
GetAttributes()

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

(Herdado de OpenXmlElement)
GetEnumerator()

Devolve um enumerador que itera através da coleção subordinada.

(Herdado de OpenXmlElement)
GetFirstChild<T>()

Localiza o primeiro elemento subordinado 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 subordinados 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 aparece depois de um elemento especificado na ordem do documento.

(Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)

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

(Herdado de OpenXmlElement)
LookupNamespace(String)

Resolve o prefixo do espaço de nomes no contexto do nó atual.

(Herdado de OpenXmlElement)
LookupPrefix(String)

Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual.

(Herdado de OpenXmlElement)
NextSibling()

Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte.

(Herdado de OpenXmlElement)
NextSibling<T>()

Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte.

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

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

(Herdado de OpenXmlCompositeElement)
PreviousSibling()

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

(Herdado de OpenXmlElement)
PreviousSibling<T>()

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

(Herdado de OpenXmlElement)
Remove()

Remove o elemento atual do respetivo elemento principal.

(Herdado de OpenXmlElement)
RemoveAllChildren()

Remove todos os elementos subordinados do elemento atual.

(Herdado de OpenXmlCompositeElement)
RemoveAllChildren<T>()

Remova todos os elementos subordinados 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 subordinado especificado.

(Herdado de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)

Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo.

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

Substitui um dos elementos subordinados 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 é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos.

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

Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos.

(Herdado de OpenXmlElement)
WriteTo(XmlWriter)

Guarda o nó atual no XmlWriter especificado.

(Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()

Validação de Dados.

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

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

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

Devolve um enumerador que itera através da coleção subordinada.

(Herdado de OpenXmlElement)

Aplica-se a