इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class DataValidation

डेटा की पुष्टि करने के नियमों को ऐक्सेस करना. नया नियम बनाने के लिए, SpreadsheetApp.newDataValidation() और DataValidationBuilder का इस्तेमाल करें. किसी रेंज के लिए पुष्टि करने का नियम सेट करने के लिए, 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()`	`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.
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);

वापसी का टिकट

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

वापसी का टिकट

DataValidationCriteria — डेटा की पुष्टि करने की शर्तों का टाइप

`getCriteriaValues()`

नियम की शर्तों के लिए आर्ग्युमेंट का कलेक्शन पाता है. शर्त का टाइप पाने के लिए, getCriteriaType() का इस्तेमाल करें. डेटा की पुष्टि करने का नियम बनाने या उसमें बदलाव करने के लिए, इन वैल्यू का इस्तेमाल करने के बारे में जानने के लिए DataValidationBuilder.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[] — नियम की शर्त के टाइप के हिसाब से ऑर्ग्युमेंट का कलेक्शन; ऑर्ग्युमेंट की संख्या और उनका टाइप, DataValidationBuilder क्लास के उससे जुड़े require...() तरीके से मेल खाता है

`getHelpText()`

इससे नियम का सहायता टेक्स्ट मिलता है. अगर कोई सहायता टेक्स्ट सेट नहीं है, तो null मिलता है.

वापसी का टिकट

String — नियम का सहायता टेक्स्ट या कोई सहायता टेक्स्ट सेट न होने पर null