NamedRange.Validation Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возвращает объект Validation, представляющий проверку данных для элемента управления NamedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property Validation As Validation
'Применение
Dim instance As NamedRange
Dim value As Validation

value = instance.Validation

[BrowsableAttribute(false)]
public Validation Validation { get; }

Значение свойства

Тип: Microsoft.Office.Interop.Excel.Validation
Объект Validation, представляющий проверку данных для элемента управления NamedRange.

Заметки

Для добавления проверки в именованный диапазон необходимо использовать обработчик событий Startup на листе. Дополнительные сведения об обработчике событий Startup см. в разделе Инструменты Visual Studio для событий проекта Office.

Примеры

В следующем примере кода свойство Validation используется для проверки того, что в NamedRange введена строка, содержащая не менее трех символов. Метод SetValidation необходимо вызывать из обработчика событий Startup.

В этом примере демонстрируется настройка уровня документа.

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.";
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Класс

NamedRange - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через