دسترسی به قوانین اعتبارسنجی داده ها برای ایجاد یک قانون جدید، از SpreadsheetApp.newDataValidation()
و DataValidationBuilder
استفاده کنید. میتوانید از Range.setDataValidation(rule)
برای تنظیم قانون اعتبارسنجی برای یک محدوده استفاده کنید.
// 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.') }
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
copy() | DataValidationBuilder | بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند. |
getAllowInvalid() | Boolean | در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه میکند، نشان میدهد، یا اگر ورودی را به طور کامل رد کند، true false . |
getCriteriaType() | DataValidationCriteria | نوع معیار قانون را همانطور که در فهرست DataValidationCriteria تعریف شده است دریافت می کند. |
getCriteriaValues() | Object[] | آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. |
getHelpText() | String | متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد، null . |
مستندات دقیق
copy()
بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.
// 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);
بازگشت
DataValidationBuilder
- سازنده بر اساس تنظیمات این قانون
getAllowInvalid()
در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه میکند، نشان میدهد، یا اگر ورودی را به طور کامل رد کند، true
false
. پیشفرض قوانین اعتبارسنجی داده جدید true
است.
بازگشت
Boolean
- true
اگر قانون اجازه ورودیهایی را بدهد که اعتبارسنجی دادهها ناموفق باشد. false
اگر نه
getCriteriaType()
نوع معیار قانون را همانطور که در فهرست DataValidationCriteria
تعریف شده است دریافت می کند. برای بدست آوردن آرگومان های معیارها، از getCriteriaValues()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به 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.') }
بازگشت
DataValidationCriteria
- نوع معیارهای اعتبارسنجی داده ها
getCriteriaValues()
آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، از getCriteriaType()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به 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.') }
بازگشت
Object[]
- آرایه ای از آرگومان های مناسب با نوع معیار قاعده. تعداد آرگومانها و نوع آنها با متد require...()
کلاس DataValidationBuilder
مطابقت دارد
getHelpText()
متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد، null
.
بازگشت
String
- متن راهنمای قانون، یا اگر متن راهنما تنظیم نشده باشد، null