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

Class DataValidation

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

`getHelpText()`

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

रिटर्न

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