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 Spreadsheet
và Data
. 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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
copy() | Data | 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. |
get | Boolean | 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. |
get | Data | Lấy loại tiêu chí của quy tắc như được xác định trong enum Data . |
get | Object[] | Lấy một mảng đối số cho tiêu chí của quy tắc. |
get | String | 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. |
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
Data
– một trình tạo dựa trên chế độ cài đặt của quy tắc này
get Allow Invalid()
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
get Criteria Type()
Lấy loại tiêu chí của quy tắc như được xác định trong enum Data
. Để lấy các đối số cho tiêu chí, hãy sử dụng get
. Để 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 Data
.
// 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
Data
– loại tiêu chí xác thực dữ liệu
get Criteria Values()
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 get
. Để 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 Data
.
// 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 Data
get Help Text()
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