Class DataValidation

Xác thựcdữ liệu

Truy cập vào 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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 một 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 dữ liệu đầu vào không được xác thực hoặc false nếu quy tắc 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ư được 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()StringLấy văn bản trợ giúp của quy tắc hoặc null nếu không đặt văn bản trợ giúp.

Tài liệu chi tiết

copy()

Tạo một 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

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

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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 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 dữ liệu đầu vào không được xác thực hoặc false nếu quy tắc 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; false nếu không

getCriteriaType()

Lấy loại tiêu chí của quy tắc như được xác định trong enum DataValidationCriteria. Để lấy các đối số cho 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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(). Để 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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 đố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()

Lấy văn bản trợ giúp của quy tắc hoặc null nếu không đặt văn bản trợ giúp.

Cầu thủ trả bóng

String – văn bản trợ giúp của quy tắc hoặc null nếu không đặt văn bản trợ giúp