Propriedade NamedRange.Validation

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
ReadOnly Property Validation As Validation
    Get

Validation Validation { get; }

Valor de propriedade

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

Comentários

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

Exemplos

O seguinte exemplo de código usa a Validation propriedade para verificar se uma seqüência de caracteres pelo menos três caracteres é inserida em um NamedRange. O SetValidation deve ser chamado o método do manipulador de eventos de inicialização.

Este exemplo é para uma personalização em nível de documento.

    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", missing],
        "namedRange1");

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

    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

Partilhar via