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