Trang này được dịch bởi Cloud Translation API.

Class 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ức	Kiểu dữ liệu trả về	Mô tả ngắn
`copy()`	`DataValidationBuilder`	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.
`getAllowInvalid()`	`Boolean`	Trả về `true` nếu quy tắc hiển thị cảnh báo khi dữ liệu nhập không thành công hoặc `false` nếu quy tắc từ chối hoàn toàn dữ liệu đầu vào.
`getCriteriaType()`	`DataValidationCriteria`	Lấy loại tiêu chí của quy tắc như được xác định trong enum `DataValidationCriteria`.
`getCriteriaValues()`	`Object[]`	Lấy một loạt các đối số cho các tiêu chí của quy tắc đó.
`getHelpText()`	`String`	Nhận văn bản trợ giúp của quy tắc hoặc `null` nếu 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 — một trình tạo dựa trên tùy chọn 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 dữ liệu nhập không thành công hoặc false nếu quy tắc từ chối hoàn toàn dữ liệu đầu vào. Theo mặc định cho các 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 nhập dữ liệu không thành công; false nếu không xác thực được dữ liệu

`getCriteriaType()`

Lấy loại tiêu chí của quy tắc như được xác định trong enum DataValidationCriteria. Để lấy đối số cho tiêu chí, hãy sử dụng getCriteriaValues(). Nếu bạn muốn 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

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

`getCriteriaValues()`

Lấy một loạt các đối số cho các tiêu chí của quy tắc đó. Để xem loại tiêu chí, hãy sử dụng getCriteriaType(). Để 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

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 đối số 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 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 chưa đặt văn bản trợ giúp nào