Class DataValidation

DataValidation

Truy cập vào các quy tắc xác thực dữ liệu. Để tạo quy tắc mới, hãy sử dụng SpreadsheetApp.newDataValidation() và DataValidationBuilder. Bạn có thể sử dụng Range.setDataValidation(rule) để đặt quy tắc xác thực cho một dải ô. 

// 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.')
}

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
copy()DataValidationBuilderTạo trình tạo cho quy tắc xác thực dữ liệu dựa trên chế độ cài đặt của quy tắc này.
getAllowInvalid()BooleanTrả về true nếu quy tắc hiển thị cảnh báo khi xác thực dữ liệu đầu vào không thành công hoặc false nếu từ chối hoàn toàn dữ liệu đầu vào.
getCriteriaType()DataValidationCriteriaLấy loại tiêu chí của quy tắc như đã xác định trong enum DataValidationCriteria.
getCriteriaValues()Object[]Lấy một mảng đối số cho tiêu chí của quy tắc.
getHelpText()StringNhận văn bản trợ giúp của quy tắc hoặc null nếu bạn chưa đặt văn bản trợ giúp nào.

Tài liệu chi tiết

copy()

Tạo trình tạo cho quy tắc xác thực dữ liệu dựa trên chế độ cài đặt của quy tắc này. 

// 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);

Cầu thủ trả bóng

DataValidationBuilder — trình tạo dựa trên các chế độ cài đặt của quy tắc này

getAllowInvalid()

Trả về true nếu quy tắc hiển thị cảnh báo khi xác thực dữ liệu đầu vào không thành công hoặc false nếu từ chối hoàn toàn dữ liệu đầu vào. Giá trị mặc định cho quy tắc xác thực dữ liệu mới là true.

Cầu thủ trả bóng

Boolean – true nếu quy tắc cho phép dữ liệu đầu vào không xác thực được dữ liệu; false nếu không

getCriteriaType()

Lấy loại tiêu chí của quy tắc như đã xác định trong enum DataValidationCriteria. Để tải đối số cho các tiêu chí, hãy sử dụng getCriteriaValues(). Để sử dụng các giá trị này nhằm tạo hoặc sửa đổi quy tắc xác thực dữ liệu (hãy xem 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.')
}

Cầu thủ trả bóng

DataValidationCriteria — loại tiêu chí xác thực dữ liệu

getCriteriaValues()

Lấy một mảng đối số cho tiêu chí của quy tắc. Để lấy loại tiêu chí, hãy sử dụng getCriteriaType(). Nếu bạn muốn sử dụng các giá trị này để tạo hoặc sửa đổi quy tắc xác thực dữ liệu, hãy xem 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.')
}

Cầu thủ trả bóng

Object[] – một mảng các đối số phù hợp với loại tiêu chí của quy tắc; số lượng đối số và loại của chúng khớp với phương thức require...() tương ứng của lớp DataValidationBuilder

getHelpText()

Nhận văn bản trợ giúp của quy tắc hoặc null nếu bạn chưa đặt văn bản trợ giúp nào.

Cầu thủ trả bóng

String — văn bản trợ giúp của quy tắc hoặc null nếu bạn chưa đặt văn bản trợ giúp