Propriedade NamedRange.Validation

Artigo
01/09/2014

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 Eventos em projetos do Office.

Exemplos

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

Este exemplo é para uma personalização de um documento 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ável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via