Class DataValidation

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Datenvalidierung

Auf Datenvalidierungsregeln zugreifen. Mit SpreadsheetApp.newDataValidation() und DataValidationBuilder können Sie eine neue Regel erstellen. Sie können Range.setDataValidation(rule) verwenden, um die Validierungsregel für einen Bereich festzulegen.

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

Methoden

MethodeRückgabetypKurzbeschreibung
copy()DataValidationBuilderErstellt einen Builder für eine Datenvalidierungsregel basierend auf den Einstellungen dieser Regel.
getAllowInvalid()BooleanGibt true zurück, wenn die Regel eine Warnung anzeigt, wenn die Eingabe bei der Datenvalidierung fehlschlägt, oder false, wenn die Eingabe vollständig abgelehnt wird.
getCriteriaType()DataValidationCriteriaRuft den Kriterientyp der Regel wie in der Aufzählung DataValidationCriteria ab.
getCriteriaValues()Object[]Ruft ein Array von Argumenten für die Kriterien der Regel ab.
getHelpText()StringRuft den Hilfetext der Regel ab oder null, wenn kein Hilfetext festgelegt ist.

Detaillierte Dokumentation

copy()

Erstellt einen Builder für eine Datenvalidierungsregel basierend auf den Einstellungen dieser Regel.

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

Zurücksenden

DataValidationBuilder: Ein Builder, der auf den Einstellungen dieser Regel basiert


getAllowInvalid()

Gibt true zurück, wenn die Regel eine Warnung anzeigt, wenn die Eingabe bei der Datenvalidierung fehlschlägt, oder false, wenn die Eingabe vollständig abgelehnt wird. Die Standardeinstellung für neue Datenvalidierungsregeln ist true.

Zurücksenden

Boolean: true wenn die Regel Eingaben erlaubt, bei denen die Datenvalidierung fehlschlägt, false wenn nicht


getCriteriaType()

Ruft den Kriterientyp der Regel wie in der Aufzählung DataValidationCriteria ab. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Informationen zum Erstellen oder Ändern einer Datenvalidierungsregel finden Sie unter 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.')
}

Zurücksenden

DataValidationCriteria: Typ der Datenvalidierungskriterien


getCriteriaValues()

Ruft ein Array von Argumenten für die Kriterien der Regel ab. Verwenden Sie getCriteriaType(), um den Kriterientyp abzurufen. Informationen zum Erstellen oder Ändern einer Datenvalidierungsregel finden Sie unter 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.')
}

Zurücksenden

Object[]: ein Array von Argumenten, die für den Kriterientyp der Regel geeignet sind. Die Anzahl der Argumente und ihr Typ entsprechen der entsprechenden Methode require...() der Klasse DataValidation.


getHelpText()

Ruft den Hilfetext der Regel ab oder null, wenn kein Hilfetext festgelegt ist.

Zurücksenden

String: Hilfetext der Regel oder null, wenn kein Hilfetext festgelegt ist