Class DataValidation

Bu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur.

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

Return

DataValidationBuilder - bu kuralın ayarlarını temel alan bir oluşturucu

Kural, giriş veri doğrulamasında başarısız olduğunda uyarı gösteriyorsa true değerini veya girişi tamamen reddetmesi durumunda false değerini döndürür. Yeni veri doğrulama kuralları için varsayılan değer true şeklindedir.

Return

Boolean — Kural, veri doğrulamasında başarısız olan girişe izin veriyorsa true; Değilse false

Kuralın DataValidationCriteria sıralamasında tanımlanan ölçüt türünü alır. To almak için bağımsız değişkenlerin olması için getCriteriaValues() kullanın. Bu değerleri kullanarak veya değiştirme hakkında daha fazla bilgi için DataValidationBuilder.withCriteria(criteria, args) sayfasına bakın.

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

Return

DataValidationCriteria — veri doğrulama kriterlerinin türü

Kuralın ölçütleri için bir bağımsız değişken dizisi alır. Ölçüt türünü almak için getCriteriaType() işlevini kullanın. Veri doğrulama kuralı oluşturmak veya değiştirmek amacıyla bu değerleri kullanmak için DataValidationBuilder.withCriteria(criteria, args) sayfasına bakın.

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

Return

Object[] — Kuralın ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişken sayısı ve türü, DataValidationBuilder sınıfının ilgili require...() yöntemiyle eşleşiyor

Kuralın yardım metnini veya yardım metni ayarlanmadıysa null değerini alır.

Return

String — kuralın yardım metni. Yardım metni ayarlanmamışsa null