Diese Seite wurde von der Cloud Translation API übersetzt.

Class DataValidationBuilder

Builder für Datenvalidierungsregeln.

// Set the data validation for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`DataValidation`	Erstellt eine Datenvalidierungsregel aus den Einstellungen, die auf den Builder angewendet wurden.
`copy()`	`DataValidationBuilder`	Erstellt einen Builder für eine Datenvalidierungsregel basierend auf den Einstellungen dieser Regel.
`getAllowInvalid()`	`Boolean`	Gibt `true` zurück, wenn die Regel eine Warnung anzeigt, wenn bei der Eingabe die Datenvalidierung fehlschlägt, oder `false`, wenn die Eingabe vollständig abgelehnt wird.
`getCriteriaType()`	`DataValidationCriteria`	Ruft den Kriterientyp der Regel gemäß der Definition in der `DataValidationCriteria`-Enum ab.
`getCriteriaValues()`	`Object[]`	Ruft ein Array von Argumenten für die Kriterien der Regel ab.
`getHelpText()`	`String`	Ruft den Hilfetext der Regel ab oder `null`, wenn kein Hilfetext festgelegt ist.
`requireCheckbox()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe ein boolescher Wert ist; ist dieser Wert als Kästchen gerendert.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Legt in der Datenvalidierungsregel fest, dass die Eingabe dem angegebenen Wert entsprechen oder leer sein muss.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Legt fest, dass die Eingabe in der Datenvalidierungsregel einen der angegebenen Werte erfordert.
`requireDate()`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel ein Datum erfordert.
`requireDateAfter(date)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel so festgelegt ist, dass ein Datum nach dem angegebenen Wert erforderlich ist.
`requireDateBefore(date)`	`DataValidationBuilder`	Legt für die Datenvalidierungsregel fest, dass ein Datum vor dem angegebenen Wert erforderlich sein muss.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Legt für die Datenvalidierungsregel fest, dass ein Datum erforderlich sein soll, das zwischen zwei oder einer von zwei liegt bestimmten Daten.
`requireDateEqualTo(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht.
`requireDateNotBetween(start, end)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das nicht in den Zeitraum zwei angegebenen Daten.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das am oder nach dem angegebenen Wert liegt.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Legt für die Datenvalidierungsregel fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder davor liegt.
`requireFormulaSatisfied(formula)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die angegebene Formel als `true` ausgewertet werden muss.
`requireNumberBetween(start, end)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die zwischen zwei oder einer von zwei liegt angegebenen Zahlen.
`requireNumberEqualTo(number)`	`DataValidationBuilder`	Legt für die Datenvalidierungsregel fest, dass eine Zahl erforderlich ist, die dem angegebenen Wert entspricht.
`requireNumberGreaterThan(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die größer als der angegebene Wert ist.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die größer oder gleich dem angegebenen Wert ist.
`requireNumberLessThan(number)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, die kleiner als der angegebene Wert ist.
`requireNumberLessThanOrEqualTo(number)`	`DataValidationBuilder`	Legt für die Datenvalidierungsregel fest, dass eine Zahl erforderlich ist, die kleiner oder gleich dem angegebenen Wert ist.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht zwischen diesen liegt und keines von beiden ist zwei angegebenen Zahlen.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die nicht dem angegebenen Wert entspricht.
`requireTextContains(text)`	`DataValidationBuilder`	Legt in der Datenvalidierungsregel fest, dass die Eingabe den angegebenen Wert enthalten muss.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Legt in der Datenvalidierungsregel fest, dass die Eingabe nicht den angegebenen Wert enthalten darf.
`requireTextEqualTo(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe dem angegebenen Wert entsprechen muss.
`requireTextIsEmail()`	`DataValidationBuilder`	Legt in der Datenvalidierungsregel fest, dass die Eingabe in Form einer E-Mail-Adresse erforderlich sein soll.
`requireTextIsUrl()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer URL erforderlich ist.
`requireValueInList(values)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss.
`requireValueInList(values, showDropdown)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss, mit der Option zum Ausblenden des Dropdown-Menüs.
`requireValueInRange(range)`	`DataValidationBuilder`	Legt in der Datenvalidierungsregel fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Legt fest, dass die Eingabe in der Datenvalidierungsregel einem Wert im angegebenen Bereich entsprechen muss mit der Option zum Ausblenden des Dropdown-Menüs.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Legt fest, ob eine Warnung angezeigt wird, wenn bei einer Eingabe die Datenvalidierung fehlschlägt, oder ob die Eingabe abgelehnt werden soll .
`setHelpText(helpText)`	`DataValidationBuilder`	Legt den Hilfetext fest, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle mit der Datenvalidierung bewegt festgelegt.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel auf Kriterien fest, die durch `DataValidationCriteria`-Werte definiert sind, normalerweise aus den `criteria` und `arguments` einer vorhandenen Regel entnommen.

Detaillierte Dokumentation

`build()`

Erstellt eine Datenvalidierungsregel aus den Einstellungen, die auf den Builder angewendet wurden.

Rückflug

DataValidation: Eine Darstellung der Datenvalidierungsregel

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

Rückflug

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

`getAllowInvalid()`

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

Rückflug

Boolean: true, wenn die Regel Eingaben zulässt, die die Datenvalidierung nicht bestehen false wenn nicht

`getCriteriaType()`

Ruft den Kriterientyp der Regel gemäß der Definition in der DataValidationCriteria-Enum ab. Um die Argumente für die Kriterien, verwenden Sie getCriteriaValues(). Um diese Werte zu verwenden, Datenvalidierungsregel ändern, siehe 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.')
}

Rückflug

DataValidationCriteria – die Art 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 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.')
}

Rückflug

Object[]: Ein Array von Argumenten, die dem Kriterientyp der Regel entsprechen. die Anzahl der Argumente und ihr Typ mit der entsprechenden require...()-Methode der DataValidationBuilder-Klasse übereinstimmt

`getHelpText()`

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

Rückflug

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

`requireCheckbox()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe ein boolescher Wert ist; ist dieser Wert als Kästchen gerendert.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireCheckbox(checkedValue)`

Legt in der Datenvalidierungsregel fest, dass die Eingabe dem angegebenen Wert entsprechen oder leer sein muss. Wann? Wenn die Eingabe mit dem angegebenen Wert übereinstimmt, wird die Zelle als aktiviertes Kästchen gerendert. Wenn der Parameter Eingabe ist leer, wird die Zelle als deaktiviertes Kontrollkästchen dargestellt.

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der Wert, der einem aktivierten Kästchen zugewiesen ist.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireCheckbox(checkedValue, uncheckedValue)`

Legt fest, dass die Eingabe in der Datenvalidierungsregel einen der angegebenen Werte erfordert. Wann? Die Eingabe ist checkedValue. Die Zelle wird als aktiviertes Kästchen gerendert. Wenn der Parameter Eingabe uncheckedValue ist, wird die Zelle als nicht angeklicktes Kästchen gerendert.

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der Wert, der einem aktivierten Kästchen zugewiesen ist.
`uncheckedValue`	`Object`	Der Wert, der einem deaktivierten Kästchen zugewiesen ist.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDate()`

Legt fest, dass die Datenvalidierungsregel ein Datum erfordert.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateAfter(date)`

Legt fest, dass die Datenvalidierungsregel so festgelegt ist, dass ein Datum nach dem angegebenen Wert erforderlich ist. Die Zeitfelder der Date-Objekte werden ignoriert. werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das letzte inakzeptable Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateBefore(date)`

Legt für die Datenvalidierungsregel fest, dass ein Datum vor dem angegebenen Wert erforderlich sein muss. Die Zeitfelder der Date-Objekte werden ignoriert. werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste inakzeptable Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateBetween(start, end)`

Legt für die Datenvalidierungsregel fest, dass ein Datum erforderlich sein soll, das zwischen zwei oder einer von zwei liegt bestimmten Daten. Die Zeitfelder der Date-Objekte werden ignoriert. nur Tag, Monat, und Jahr verwendet.

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Date`	Das früheste akzeptable Datum.
`end`	`Date`	Das späteste zulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateEqualTo(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht. Die Zeitfelder der Date-Objekt werden ignoriert. werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das einzige zulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateNotBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das nicht in den Zeitraum zwei angegebenen Daten. Die Zeitfelder der Date-Objekte werden ignoriert. nur den Tag, Die Felder „Monat“ und „Jahr“ werden verwendet.

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Date`	Das früheste inakzeptable Datum.
`end`	`Date`	Das letzte inakzeptable Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateOnOrAfter(date)`

Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das am oder nach dem angegebenen Wert liegt. Die Zeitfelder der Date-Objekt werden ignoriert. werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste akzeptable Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireDateOnOrBefore(date)`

Legt für die Datenvalidierungsregel fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder davor liegt. Die Zeitfelder des Date-Objekts werden ignoriert. werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das späteste zulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireFormulaSatisfied(formula)`

Legt für die Datenvalidierungsregel fest, dass die angegebene Formel als true ausgewertet werden muss.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Eine benutzerdefinierte Formel, die `true` ergibt, wenn die Eingabe gültig ist.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberBetween(start, end)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die zwischen zwei oder einer von zwei liegt angegebenen Zahlen.

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste zulässige Wert.
`end`	`Number`	Der höchste akzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberEqualTo(number)`

Legt für die Datenvalidierungsregel fest, dass eine Zahl erforderlich ist, die dem angegebenen Wert entspricht.

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der einzige akzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberGreaterThan(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die größer als der angegebene Wert ist.

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste inakzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberGreaterThanOrEqualTo(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die größer oder gleich dem angegebenen Wert ist.

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der niedrigste zulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberLessThan(number)`

Legt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, die kleiner als der angegebene Wert ist.

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der niedrigste inakzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberLessThanOrEqualTo(number)`

Legt für die Datenvalidierungsregel fest, dass eine Zahl erforderlich ist, die kleiner oder gleich dem angegebenen Wert ist.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste akzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberNotBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht zwischen diesen liegt und keines von beiden ist zwei angegebenen Zahlen.

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste inakzeptable Wert.
`end`	`Number`	Der höchste inakzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireNumberNotEqualTo(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die nicht dem angegebenen Wert entspricht.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der einzige inakzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireTextContains(text)`

Legt in der Datenvalidierungsregel fest, dass die Eingabe den angegebenen Wert enthalten muss.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der Wert, den die Eingabe enthalten muss.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireTextDoesNotContain(text)`

Legt in der Datenvalidierungsregel fest, dass die Eingabe nicht den angegebenen Wert enthalten darf.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der Wert, den die Eingabe nicht enthalten darf.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireTextEqualTo(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe dem angegebenen Wert entsprechen muss.

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der einzige akzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireTextIsEmail()`

Legt in der Datenvalidierungsregel fest, dass die Eingabe in Form einer E-Mail-Adresse erforderlich sein soll.

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireTextIsUrl()`

Legt in der Datenvalidierungsregel fest, dass die Eingabe in Form einer URL erforderlich sein soll.

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireValueInList(values)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	Ein Array mit zulässigen Werten.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireValueInList(values, showDropdown)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss, mit der Option zum Ausblenden des Dropdown-Menüs.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	Ein Array mit zulässigen Werten.
`showDropdown`	`Boolean`	`true`, wenn die Tabelle ein Drop-down-Menü für die Werte anzeigen soll; `false`, wenn nicht.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireValueInRange(range)`

Legt in der Datenvalidierungsregel fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss.

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Ein Bereich, der die zulässigen Werte enthält.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`requireValueInRange(range, showDropdown)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss mit der Option zum Ausblenden des Dropdown-Menüs.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Ein Bereich, der die zulässigen Werte enthält.
`showDropdown`	`Boolean`	`true`, wenn die Tabelle ein Drop-down-Menü für die Werte anzeigen soll; `false`, wenn nicht.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`setAllowInvalid(allowInvalidData)`

Legt fest, ob eine Warnung angezeigt wird, wenn bei einer Eingabe die Datenvalidierung fehlschlägt, oder ob die Eingabe abgelehnt werden soll . Die Standardeinstellung für neue Datenvalidierungsregeln ist true.

Parameter

Name	Typ	Beschreibung
`allowInvalidData`	`Boolean`	`true`, wenn die Regel Eingaben zulassen soll, die die Datenvalidierung nicht bestehen `false`, wenn nicht.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`setHelpText(helpText)`

Legt den Hilfetext fest, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle mit der Datenvalidierung bewegt festgelegt.

Parameter

Name	Typ	Beschreibung
`helpText`	`String`	Der festzulegende Hilfetext.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen

`withCriteria(criteria, args)`

Legt die Datenvalidierungsregel auf Kriterien fest, die durch DataValidationCriteria-Werte definiert sind, normalerweise aus den criteria und arguments einer vorhandenen Regel entnommen.

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

Parameter

Name	Typ	Beschreibung
`criteria`	`DataValidationCriteria`	Der Typ der Datenvalidierungskriterien.
`args`	`Object[]`	Ein Array von Argumenten, die dem Kriterientyp entsprechen. die Anzahl der Argumente und Ihr Typ entspricht der entsprechenden `require...()`-Methode oben.

Rückflug

DataValidationBuilder – dieser Builder für Verkettungen