این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class DataValidation

دسترسی به قوانین اعتبارسنجی داده ها برای ایجاد یک قانون جدید، از Spreadsheet App.newDataValidation() و Data Validation Builder استفاده کنید. می‌توانید از Range.setDataValidation(rule) برای تنظیم قانون اعتبارسنجی برای یک محدوده استفاده کنید.

// 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.');
}

روش ها

روش	نوع برگشت	شرح مختصر
`copy()`	`Data Validation Builder`	بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.
`get Allow Invalid()`	`Boolean`	در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، `true` `false` .
`get Criteria Type()`	`Data Validation Criteria`	نوع معیار قانون را همانطور که در فهرست `Data Validation Criteria` تعریف شده است، دریافت می کند.
`get Criteria Values()`	`Object[]`	آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند.
`get Help Text()`	`String`	متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد، `null` .

مستندات دقیق

`copy()`

بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.

// 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);

بازگشت

Data Validation Builder - سازنده ای بر اساس تنظیمات این قانون

`get Allow Invalid()`

در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، true false . پیش‌فرض قوانین اعتبارسنجی داده جدید true است.

بازگشت

Boolean - true اگر قانون اجازه ورودی‌هایی را بدهد که اعتبارسنجی داده‌ها ناموفق باشد. false اگر نه

`get Criteria Type()`

نوع معیار قانون را همانطور که در فهرست Data Validation Criteria تعریف شده است، دریافت می کند. برای بدست آوردن آرگومان های معیارها، get Criteria Values() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به Data Validation Builder.withCriteria(criteria, args) مراجعه کنید.

// 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.');
}

بازگشت

Data Validation Criteria - نوع معیارهای اعتبارسنجی داده ها

`get Criteria Values()`

آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، get Criteria Type() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به Data Validation Builder.withCriteria(criteria, args) مراجعه کنید.

// 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.');
}

بازگشت

Object[] - آرایه ای از آرگومان های مناسب با نوع معیار قاعده. تعداد آرگومان‌ها و نوع آن‌ها با متد require...() کلاس Data Validation Builder مطابقت دارد

`get Help Text()`

متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد، null .

بازگشت

String - متن راهنمای قانون، یا اگر متن راهنما تنظیم نشده باشد، null