Trình tạo quy tắc xác thực dữ liệu.
// Set the data validation for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
build() | DataValidation | Tạo quy tắc xác thực dữ liệu từ chế độ cài đặt áp dụng cho trình tạo. |
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. |
requireCheckbox() | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị boolean; giá trị này được hiển thị dưới dạng hộp đánh dấu. |
requireCheckbox(checkedValue) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị được chỉ định hoặc để trống. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là một trong các giá trị đã chỉ định. |
requireDate() | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu bắt buộc phải có ngày. |
requireDateAfter(date) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu yêu cầu một ngày sau giá trị đã cho. |
requireDateBefore(date) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu yêu cầu phải có một ngày trước giá trị đã cho. |
requireDateBetween(start, end) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệu để yêu cầu ngày nằm trong khoảng hoặc là một trong hai ngày đã chỉ định. |
requireDateEqualTo(date) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu yêu cầu một ngày bằng với giá trị đã cho. |
requireDateNotBetween(start, end) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệu yêu cầu một ngày không nằm trong khoảng và không nằm trong hai ngày đã chỉ định. |
requireDateOnOrAfter(date) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu một ngày vào hoặc sau giá trị đã cho. |
requireDateOnOrBefore(date) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu yêu cầu một ngày vào hoặc trước giá trị đã cho. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu yêu cầu công thức đã cho có giá trị là true . |
requireNumberBetween(start, end) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệu để yêu cầu một số nằm trong hoặc là một trong hai số được chỉ định. |
requireNumberEqualTo(number) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số bằng với giá trị đã cho. |
requireNumberGreaterThan(number) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn giá trị đã cho. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn hoặc bằng giá trị đã cho. |
requireNumberLessThan(number) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu yêu cầu một số nhỏ hơn giá trị đã cho. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số nhỏ hơn hoặc bằng giá trị đã cho. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệu để yêu cầu một số không nằm trong khoảng và không nằm trong hai số được chỉ định. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số không bằng giá trị đã cho. |
requireTextContains(text) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào chứa giá trị đã cho. |
requireTextDoesNotContain(text) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào không chứa giá trị đã cho. |
requireTextEqualTo(text) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với giá trị đã cho. |
requireTextIsEmail() | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng địa chỉ email. |
requireTextIsUrl() | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng URL. |
requireValueInList(values) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng một trong các giá trị đã cho. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với một trong các giá trị đã cho, với tuỳ chọn ẩn trình đơn thả xuống. |
requireValueInRange(range) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu giá trị nhập vào bằng một giá trị trong phạm vi đã cho. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng với một giá trị trong dải ô đã cho, với tuỳ chọn ẩn trình đơn thả xuống. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Thiết lập xem có hiển thị cảnh báo khi dữ liệu nhập không thành công hay không hoặc có từ chối toàn bộ dữ liệu đầu vào hay không. |
setHelpText(helpText) | DataValidationBuilder | Thiết lập văn bản trợ giúp xuất hiện khi người dùng di chuột qua ô đã đặt tính năng xác thực dữ liệu. |
withCriteria(criteria, args) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệu thành tiêu chí được xác định bằng các giá trị DataValidationCriteria , thường được lấy từ criteria và arguments của một quy tắc hiện có. |
Tài liệu chi tiết
build()
Tạo quy tắc xác thực dữ liệu từ chế độ cài đặt áp dụng cho trình tạo.
Cầu thủ trả bóng
DataValidation
— nội dung trình bày quy tắc xác thực dữ liệu
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 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 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
requireCheckbox()
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị boolean; giá trị này được hiển thị dưới dạng hộp đánh dấu.
// Set the data validation for cell A1 to require a boolean value; the value is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build(); cell.setDataValidation(rule);
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireCheckbox(checkedValue)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị được chỉ định hoặc để trống. Khi giá trị nhập khớp với giá trị đã chỉ định, ô sẽ hiển thị dưới dạng hộp đánh dấu đã đánh dấu. Khi giá trị nhập trống, ô hiển thị dưới dạng hộp đánh dấu đã bỏ đánh dấu.
// Set the data validation for cell A1 to require a custom checked value that is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
checkedValue | Object | Giá trị được gán cho hộp đã đánh dấu. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireCheckbox(checkedValue, uncheckedValue)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là một trong các giá trị đã chỉ định. Khi giá trị nhập là checkedValue
, ô này sẽ hiển thị dưới dạng hộp đánh dấu đã đánh dấu. Khi giá trị nhập là uncheckedValue
, ô sẽ hiển thị dưới dạng hộp đánh dấu đã bỏ đánh dấu.
// Set the data validation for cell A1 to require custom checked values that are rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
checkedValue | Object | Giá trị được gán cho hộp đã đánh dấu. |
uncheckedValue | Object | Giá trị được gán cho hộp đánh dấu. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDate()
Thiết lập quy tắc xác thực dữ liệu bắt buộc phải có ngày.
// Set the data validation for cell A1 to require a date. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDate().build(); cell.setDataValidation(rule);
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateAfter(date)
Thiết lập quy tắc xác thực dữ liệu yêu cầu một ngày sau giá trị đã cho. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | Ngày không được chấp nhận muộn nhất. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateBefore(date)
Thiết lập quy tắc xác thực dữ liệu yêu cầu phải có một ngày trước giá trị đã cho. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | Ngày sớm nhất không được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateBetween(start, end)
Đặt quy tắc xác thực dữ liệu để yêu cầu ngày nằm trong khoảng hoặc là một trong hai ngày đã chỉ định. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
start | Date | Ngày chấp nhận được sớm nhất. |
end | Date | Ngày được chấp nhận mới nhất. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateEqualTo(date)
Thiết lập quy tắc xác thực dữ liệu yêu cầu một ngày bằng với giá trị đã cho. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date equal to January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013')) .build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | Ngày duy nhất được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateNotBetween(start, end)
Đặt quy tắc xác thực dữ liệu yêu cầu một ngày không nằm trong khoảng và không nằm trong hai ngày đã chỉ định. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date not in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
start | Date | Ngày sớm nhất không được chấp nhận. |
end | Date | Ngày không được chấp nhận muộn nhất. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateOnOrAfter(date)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu một ngày vào hoặc sau giá trị đã cho. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date on or after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | Ngày chấp nhận được sớm nhất. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireDateOnOrBefore(date)
Thiết lập quy tắc xác thực dữ liệu yêu cầu một ngày vào hoặc trước giá trị đã cho. Các trường thời gian của đối tượng Date
sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.
// Set the data validation for cell A1 to require a date on or before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | Ngày được chấp nhận mới nhất. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireFormulaSatisfied(formula)
Thiết lập quy tắc xác thực dữ liệu yêu cầu công thức đã cho có giá trị là true
.
// Set the data validation for cell A1 to equal B1 with a custom formula. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formula | String | Một công thức tuỳ chỉnh đánh giá là true nếu giá trị nhập vào là hợp lệ. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberBetween(start, end)
Đặt quy tắc xác thực dữ liệu để yêu cầu một số nằm trong hoặc là một trong hai số được chỉ định.
// Set the data validation for cell A1 to require a number between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
start | Number | Giá trị thấp nhất được chấp nhận. |
end | Number | Giá trị cao nhất được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberEqualTo(number)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số bằng với giá trị đã cho.
// Set the data validation for cell A1 to require a number equal to 3.1415926536. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
number | Number | Giá trị duy nhất được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberGreaterThan(number)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn giá trị đã cho.
// Set the data validation for cell A1 to require a number greater than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
number | Number | Giá trị cao nhất không được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberGreaterThanOrEqualTo(number)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn hoặc bằng giá trị đã cho.
// Set the data validation for cell A1 to require a number greater than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
number | Number | Giá trị thấp nhất được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberLessThan(number)
Thiết lập quy tắc xác thực dữ liệu yêu cầu một số nhỏ hơn giá trị đã cho.
// Set the data validation for cell A1 to require a number less than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
number | Number | Giá trị thấp nhất không được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberLessThanOrEqualTo(number)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số nhỏ hơn hoặc bằng giá trị đã cho.
// Set the data validation for cell A1 to require a number less than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
number | Number | Giá trị cao nhất được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberNotBetween(start, end)
Đặt quy tắc xác thực dữ liệu để yêu cầu một số không nằm trong khoảng và không nằm trong hai số được chỉ định.
// Set the data validation for cell A1 to require a number not between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
start | Number | Giá trị thấp nhất không được chấp nhận. |
end | Number | Giá trị cao nhất không được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireNumberNotEqualTo(number)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu một số không bằng giá trị đã cho.
// Set the data validation for cell A1 to require a number not equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
number | Number | Giá trị duy nhất không được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireTextContains(text)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào chứa giá trị đã cho.
// Set the data validation for cell A1 to require any value that includes "Google". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | Giá trị mà giá trị nhập phải chứa. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireTextDoesNotContain(text)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào không chứa giá trị đã cho.
// Set the data validation for cell A1 to require any value that does not include "@". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | Giá trị mà giá trị nhập không được chứa. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireTextEqualTo(text)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với giá trị đã cho.
// Set the data validation for cell A1 to require "Yes". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | Giá trị duy nhất được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireTextIsEmail()
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng địa chỉ email.
// Set the data validation for cell A1 to require text in the form of an email address. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build(); cell.setDataValidation(rule);
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireTextIsUrl()
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng URL.
// Set the data validation for cell A1 to require text in the form of a URL. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build(); cell.setDataValidation(rule);
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireValueInList(values)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng một trong các giá trị đã cho.
// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
values | String[] | Một mảng các giá trị được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireValueInList(values, showDropdown)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với một trong các giá trị đã cho, với tuỳ chọn ẩn trình đơn thả xuống.
// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
values | String[] | Một mảng các giá trị được chấp nhận. |
showDropdown | Boolean | true nếu bảng tính hiển thị trình đơn thả xuống cho các giá trị; false nếu không thấy. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireValueInRange(range)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu giá trị nhập vào bằng một giá trị trong phạm vi đã cho.
// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
range | Range | Dải ô chứa các giá trị được chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
requireValueInRange(range, showDropdown)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng với một giá trị trong dải ô đã cho, với tuỳ chọn ẩn trình đơn thả xuống.
// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
range | Range | Dải ô chứa các giá trị được chấp nhận. |
showDropdown | Boolean | true nếu bảng tính hiển thị trình đơn thả xuống cho các giá trị; false nếu không thấy. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
setAllowInvalid(allowInvalidData)
Thiết lập xem có hiển thị cảnh báo khi dữ liệu nhập không thành công hay không hoặc có từ chối toàn bộ dữ liệu đầu vào hay không. Theo mặc định cho các quy tắc xác thực dữ liệu mới là true
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
allowInvalidData | 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 được. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
setHelpText(helpText)
Thiết lập văn bản trợ giúp xuất hiện khi người dùng di chuột qua ô đã đặt tính năng xác thực dữ liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
helpText | String | Văn bản trợ giúp để thiết lập. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi
withCriteria(criteria, args)
Đặt quy tắc xác thực dữ liệu thành tiêu chí được xác định bằng các giá trị DataValidationCriteria
, thường được lấy từ criteria
và arguments
của một quy tắc hiện có.
// 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ác tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
criteria | DataValidationCriteria | Loại tiêu chí xác thực dữ liệu. |
args | Object[] | Một mảng các đối số phù hợp với loại tiêu chí; số lượng đối số và loại của các đối số đó khớp với phương thức require...() tương ứng ở trên. |
Cầu thủ trả bóng
DataValidationBuilder
— trình tạo này để tạo chuỗi