Trình tạo các 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 | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
build() | DataValidation | Tạo quy tắc xác thực dữ liệu từ các 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 xác thực dữ liệu đầu vào không thành công hoặc false nếu 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ư đã 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() | String | Nhận văn bản trợ giúp của quy tắc hoặc null nếu bạn 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 phải là giá trị boolean; giá trị này là hiển thị dưới dạng một 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ị được chỉ định. |
requireDate() | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu 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 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 hoặc giữa hai các ngày cụ thể. |
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 giá trị đã cho. |
requireDateNotBetween(start, end) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu ngày không nằm trong khoảng và không nằm trong khoảng 2 ngày cụ thể. |
requireDateOnOrAfter(date) | DataValidationBuilder | Thiết lập quy tắc xác thực dữ liệu để yêu cầu 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 để quy tắc này yêu cầu ngày vào hoặc trước giá trị đã cho. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệ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 khoảng hoặc là một trong hai các số cụ thể. |
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 giá trị đã cho. |
requireNumberGreaterThan(number) | DataValidationBuilder | Đặt 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 | Đặt 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 | Đặt 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 | Đặt 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 khoảng nào là 2 số cụ thể. |
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 phải 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 phải bằng 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 phải ở 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 phải có 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 phải 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 phải bằng 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 dữ liệu đầu vào phải bằng một giá trị trong dải ô đã 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 một giá trị trong phạm vi đã cho, với tuỳ chọn ẩn trình đơn thả xuống. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Đặt xem có hiển thị cảnh báo khi dữ liệu đầu vào không xác thực được hoặc có từ chối dữ liệu đầu vào hay không hoàn toàn. |
setHelpText(helpText) | DataValidationBuilder | Đặt văn bản trợ giúp xuất hiện khi người dùng di chuột qua ô cần xác thực dữ liệu thiết lập. |
withCriteria(criteria, args) | DataValidationBuilder | Đặt quy tắc xác thực dữ liệu thành các tiêu chí do giá trị DataValidationCriteria xác định,
thường được lấy từ criteria và arguments của quy tắc hiện tại. |
Tài liệu chi tiết
build()
Tạo quy tắc xác thực dữ liệu từ các chế độ cài đặt áp dụng cho trình tạo.
Cầu thủ trả bóng
DataValidation
— bản trình bày của 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
— trình tạo dựa trên các 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 xác thực dữ liệu đầu vào không thành công hoặc false
nếu 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 dữ liệu; false
nếu không
getCriteriaType()
Lấy loại tiêu chí của quy tắc như đã xác định trong enum DataValidationCriteria
. Để tải
đối số cho các 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 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 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()
. Nếu bạn muốn sử 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
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 của chúng 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 bạn 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 bạn chưa đặt văn bản trợ giúp
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 phải là giá trị boolean; giá trị này là hiển thị dưới dạng một 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. Thời gian giá trị đầu vào khớp với giá trị được chỉ định mà ô được kết xuất dưới dạng hộp đánh dấu đã đánh dấu. Khi giá trị nhập bị trống, ô hiển thị dưới dạng hộp đánh dấu không được đá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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
checkedValue | Object | Giá trị được gán cho một hộp đã chọn. |
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ị được chỉ định. Thời gian
giá trị nhập là checkedValue
ô hiển thị dưới dạng một hộp đánh dấu đã đánh dấu. Khi
giá trị nhập là uncheckedValue
ô hiển thị dưới dạng hộp đánh dấu không được đá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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
checkedValue | Object | Giá trị được gán cho một hộp đã chọn. |
uncheckedValue | Object | Giá trị được gán cho một hộp chưa đá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 để yêu cầu 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. Trường thời gian của
Đối tượng Date
bị bỏ qua; chỉ sử 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
date | Date | Ngày gần đây 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
requireDateBefore(date)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu có một ngày trước giá trị đã cho. Trường thời gian của
Đối tượng Date
bị bỏ qua; chỉ sử 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);
Tham số
Tên | Loại | 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 hoặc giữa hai
các ngày cụ thể. Các trường thời gian của đối tượng Date
bị bỏ qua; chỉ ngày, tháng
và năm đều được sử dụng.
// 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
start | Date | Ngày sớm nhất được chấp nhận. |
end | Date | Ngày gần nhất có thể chấp nhận. |
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 giá trị đã cho. Trường thời gian của
đối tượng Date
bị bỏ qua; chỉ sử 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);
Tham số
Tên | Loại | 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)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu ngày không nằm trong khoảng và không nằm trong khoảng
2 ngày cụ thể. Các trường thời gian của đối tượng Date
bị bỏ qua; chỉ trong ngày,
tháng và năm được sử dụng.
// 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
start | Date | Ngày sớm nhất không được chấp nhận. |
end | Date | Ngày gần đây 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
requireDateOnOrAfter(date)
Thiết lập quy tắc xác thực dữ liệu để yêu cầu ngày vào hoặc sau giá trị đã cho. Trường thời gian của
đối tượng Date
bị bỏ qua; chỉ sử 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
date | Date | Ngày sớm nhất được chấp nhận. |
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 để quy tắc này yêu cầu ngày vào hoặc trước giá trị đã cho. Trường thời gian
của đối tượng Date
sẽ bị bỏ qua; chỉ sử 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
date | Date | Ngày gần nhất có thể chấp nhận. |
Cầu thủ trả bóng
DataValidationBuilder
– trình tạo này, để tạo chuỗi
requireFormulaSatisfied(formula)
Đặt quy tắc xác thực dữ liệ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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
formula | String | Một công thức tuỳ chỉnh được đánh giá là true nếu dữ liệu đầu vào 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 khoảng hoặc là một trong hai các số cụ thể.
// 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
start | Number | Giá trị thấp nhất chấp nhận được. |
end | Number | Giá trị cao nhất chấp nhận được. |
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 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);
Tham số
Tên | Loại | 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)
Đặt 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);
Tham số
Tên | Loại | 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)
Đặt 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
number | Number | Giá trị thấp nhất chấp nhận được. |
Cầu thủ trả bóng
DataValidationBuilder
– trình tạo này, để tạo chuỗi
requireNumberLessThan(number)
Đặt 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);
Tham số
Tên | Loại | 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)
Đặt 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
number | Number | Giá trị cao nhất chấp nhận được. |
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 khoảng nào là 2 số cụ thể.
// 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);
Tham số
Tên | Loại | 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);
Tham số
Tên | Loại | 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 phải 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Giá trị mà dữ liệu đầu vào phải có. |
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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Giá trị mà dữ liệu đầu vào 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 phải bằng 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);
Tham số
Tên | Loại | 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 phải ở 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 phải có 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 phải 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);
Tham số
Tên | Loại | 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 phải bằng 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);
Tham số
Tên | Loại | 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. |
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 dữ liệu đầu vào phải bằng một giá trị trong dải ô đã 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);
Tham số
Tên | Loại | 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 một giá trị trong phạm vi đã 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);
Tham số
Tên | Loại | 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. |
Cầu thủ trả bóng
DataValidationBuilder
– trình tạo này, để tạo chuỗi
setAllowInvalid(allowInvalidData)
Đặt xem có hiển thị cảnh báo khi dữ liệu đầu vào không xác thực được hoặc có từ chối dữ liệu đầu vào hay không
hoàn toàn. Giá trị mặc định cho quy tắc xác thực dữ liệu mới là true
.
Tham số
Tên | Loại | 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ầu thủ trả bóng
DataValidationBuilder
– trình tạo này, để tạo chuỗi
setHelpText(helpText)
Đặt văn bản trợ giúp xuất hiện khi người dùng di chuột qua ô cần xác thực dữ liệu thiết lập.
Tham số
Tên | Loại | Mô tả |
---|---|---|
helpText | String | Văn bản trợ giúp cần đặt. |
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 các tiêu chí do giá trị DataValidationCriteria
xác định,
thường được lấy từ criteria
và arguments
của quy tắc hiện tại.
// 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);
Tham số
Tên | Loại | 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 chúng 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