此页面由 Cloud Translation API 翻译。

Class DataValidation

访问数据验证规则。如需创建新规则，请使用 SpreadsheetApp.newDataValidation() 和 DataValidationBuilder。您可以使用使用 Range.setDataValidation(rule) 设置范围的验证规则。

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

方法

方法	返回类型	简介
`copy()`	`DataValidationBuilder`	根据此规则的设置，为数据验证规则创建构建器。
`getAllowInvalid()`	`Boolean`	如果规则在输入数据验证失败时显示警告，则返回 `true`；如果规则完全拒绝输入，则返回 `false`。
`getCriteriaType()`	`DataValidationCriteria`	获取 `DataValidationCriteria` 枚举中定义的规则条件类型。
`getCriteriaValues()`	`Object[]`	获取规则条件的一组参数。
`getHelpText()`	`String`	获取规则的帮助文本，如果未设置帮助文本，则返回 `null`。

详细文档

`copy()`

根据此规则的设置，为数据验证规则创建构建器。

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

DataValidationBuilder - 基于此规则设置的构建器

`getAllowInvalid()`

如果规则在输入数据验证失败时显示警告，则返回 true；如果规则完全拒绝输入，则返回 false。新数据验证规则的默认值为 true。

Boolean - 如果规则允许未通过数据验证的输入，则为 true；如果不是，则为 false

`getCriteriaType()`

获取 DataValidationCriteria 枚举中定义的规则条件类型。要获取条件参数，请使用 getCriteriaValues()。要使用这些值来创建或修改数据验证规则，请参阅 DataValidationBuilder.withCriteria(criteria, args)。

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

DataValidationCriteria - 数据验证条件的类型

`getCriteriaValues()`

获取规则条件的一组参数。要获取条件类型，请使用 getCriteriaType()。如需使用这些值创建或修改数据验证规则，请参阅 DataValidationBuilder.withCriteria(criteria, args)。

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Object[] - 适用于规则的条件类型的参数数组；参数数量并且其类型与 DataValidationBuilder 类的相应 require...() 方法匹配

`getHelpText()`

获取规则的帮助文本，如果未设置帮助文本，则返回 null。

String - 规则的帮助文本，如果未设置帮助文本，则为 null