Propriedade NamedRange.Validation

Artigo
05/21/2013

Obtém um objeto de Validation que representa a validação de dados para o controle de NamedRange .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
ReadOnly Property Validation As Validation

Validation Validation { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Validation
Um objeto de Validation que representa a validação de dados para o controle de NamedRange .

Comentários

Você deve usar o manipulador de eventos de inicialização de uma planilha para adicionar validação a um intervalo nomeado.Para obter mais informações sobre o manipulador de eventos de inicialização, consulte o Eventos em projetos do Office.

Exemplos

O exemplo de código a seguir usa a propriedade de Validation para verificar se uma cadeia de caracteres com pelo menos três caracteres está inserida em NamedRange.O método de SetValidation deve ser chamado de manipulador de eventos de inicialização.

Este exemplo é para uma personalização da nível.

    Private Sub SetValidation()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Validation.Add( _
            Excel.XlDVType.xlValidateTextLength, _
            Excel.XlDVAlertStyle.xlValidAlertStop, _
            Excel.XlFormatConditionOperator.xlGreater, 3, )

        namedRange1.Validation.InputMessage = "Enter a name."
        namedRange1.Validation.ErrorMessage = _
            "Please enter a name with 3 or more characters."
    End Sub

private void SetValidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    namedRange1.Validation.Add(
        Excel.XlDVType.xlValidateTextLength,
        Excel.XlDVAlertStyle.xlValidAlertStop,
        Excel.XlFormatConditionOperator.xlGreater, 3);

    namedRange1.Validation.InputMessage = "Enter a name.";
    namedRange1.Validation.ErrorMessage =
        "Please enter a name with 3 or more characters.";
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via