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 die Eingabe bei der Datenvalidierung fehlschlägt, oder `false`, wenn die Eingabe vollständig abgelehnt wird.
`getCriteriaType()`	`DataValidationCriteria`	Ruft 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()`	`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 sein muss. Dieser Wert wird als Kästchen gerendert.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel der angegebene Wert erforderlich ist oder das Feld leer ist.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einen der angegebenen Werte erfordern muss.
`requireDate()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist.
`requireDateAfter(date)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel ein Datum nach dem angegebenen Wert erforderlich ist.
`requireDateBefore(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum vor dem angegebenen Wert erforderlich ist.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das zwischen zwei angegebenen Daten liegt oder einen dieser Werte umfasst.
`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 zwischen zwei angegebenen Daten liegt und nicht zwischen ihnen liegt.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum an oder nach dem angegebenen Wert erforderlich ist.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so 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 die Datenvalidierungsregel so fest, dass eine Zahl zwischen zwei angegebenen Zahlen oder einer davon erforderlich ist.
`requireNumberEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, die dem angegebenen Wert entspricht.
`requireNumberGreaterThan(number)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, die größer als der angegebene Wert ist.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel eine Zahl größer oder gleich dem angegebenen Wert erforderlich 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 fest, dass für die Datenvalidierungsregel eine Zahl kleiner oder gleich dem angegebenen Wert erforderlich ist.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und nicht zwischen ihnen liegt.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl ungleich dem angegebenen Wert erforderlich ist.
`requireTextContains(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert enthalten muss.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe nicht den angegebenen Wert enthalten muss.
`requireTextEqualTo(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe gleich dem angegebenen Wert sein muss.
`requireTextIsEmail()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer E-Mail-Adresse erforderlich ist.
`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 mit einem der angegebenen Werte übereinstimmen muss, mit der Option, das Drop-down-Menü auszublenden.
`requireValueInRange(range)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss, wobei das Drop-down-Menü ausgeblendet werden kann.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Legt fest, ob eine Warnung angezeigt wird, wenn die Eingabe die Datenvalidierung nicht besteht oder ob die Eingabe vollständig abgelehnt werden soll.
`setHelpText(helpText)`	`DataValidationBuilder`	Legt den Hilfetext fest, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle bewegt, für die die Datenvalidierung festgelegt ist.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel auf Kriterien fest, die durch `DataValidationCriteria`-Werte definiert sind. Diese werden normalerweise aus den `criteria` und `arguments` einer vorhandenen Regel übernommen.

Detaillierte Dokumentation

`build()`

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

Zurücksenden

DataValidation: 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);

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 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 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 DataValidationBuilder.

`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

`requireCheckbox()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe ein boolescher Wert sein muss. Dieser Wert wird 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);

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireCheckbox(checkedValue)`

Legt fest, dass für die Datenvalidierungsregel der angegebene Wert erforderlich ist oder das Feld leer ist. Wenn die Eingabe mit dem angegebenen Wert übereinstimmt, wird die Zelle als Kästchen angeklickt. Wenn die Eingabe leer ist, wird die Zelle als Häkchen aus dem Kästchen entfernt.

// 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 Kästchen zugewiesen ist.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireCheckbox(checkedValue, uncheckedValue)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einen der angegebenen Werte erfordern muss. Ist als Eingabe checkedValue festgelegt, wird die Zelle als Kästchen angeklickt. Ist uncheckedValue ausgewählt, wird die Zelle als Häkchen entfernt.

// 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 Kästchen zugewiesen ist.
`uncheckedValue`	`Object`	Der Wert, der einem nicht ausgewählten Kästchen zugewiesen ist.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDate()`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist.

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

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateAfter(date)`

Legt fest, dass für die Datenvalidierungsregel ein Datum nach dem angegebenen Wert erforderlich ist. Die Zeitfelder des Date-Objekts werden ignoriert. Es 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 späteste inakzeptable Datum.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateBefore(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum vor dem angegebenen Wert erforderlich ist. Die Zeitfelder des Date-Objekts werden ignoriert. Es 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das zwischen zwei angegebenen Daten liegt oder einen dieser Werte umfasst. Die Zeitfelder der Date-Objekte werden ignoriert. Nur die Felder für Tag, Monat und Jahr werden 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 zulässige Datum.
`end`	`Date`	Das späteste zulässige Datum.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateEqualTo(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht. Die Zeitfelder des Date-Objekts werden ignoriert. Es 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 akzeptable Datum.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateNotBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das nicht zwischen zwei angegebenen Daten liegt und nicht zwischen ihnen liegt. Die Zeitfelder der Date-Objekte werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr 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 späteste inakzeptable Datum.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateOnOrAfter(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum an oder nach dem angegebenen Wert erforderlich ist. Die Zeitfelder des Date-Objekts werden ignoriert. Es 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 zulässige Datum.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireDateOnOrBefore(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder davor liegt. Die Zeitfelder des Date-Objekts werden ignoriert. Es 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireFormulaSatisfied(formula)`

Legt die Datenvalidierungsregel so 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` ausgewertet wird, wenn die Eingabe gültig ist.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass eine Zahl zwischen zwei angegebenen Zahlen oder einer davon erforderlich ist.

// 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 zulässige Wert.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberEqualTo(number)`

Legt fest, dass für die Datenvalidierungsregel 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 zulässige Wert.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberGreaterThan(number)`

Legt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberGreaterThanOrEqualTo(number)`

Legt fest, dass für die Datenvalidierungsregel eine Zahl größer oder gleich dem angegebenen Wert erforderlich 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberLessThanOrEqualTo(number)`

Legt fest, dass für die Datenvalidierungsregel eine Zahl kleiner oder gleich dem angegebenen Wert erforderlich 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 zulässige Wert.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberNotBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und nicht zwischen ihnen liegt.

// 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireNumberNotEqualTo(number)`

Legt die Datenvalidierungsregel so fest, dass eine Zahl ungleich dem angegebenen Wert erforderlich ist.

// 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireTextContains(text)`

Legt die Datenvalidierungsregel so 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireTextDoesNotContain(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe nicht den angegebenen Wert enthalten muss.

// 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireTextEqualTo(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe gleich dem angegebenen Wert sein 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 zulässige Wert.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireTextIsEmail()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer E-Mail-Adresse erforderlich ist.

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

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireTextIsUrl()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer URL erforderlich ist.

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

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`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 zulässiger Werte.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireValueInList(values, showDropdown)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe mit einem der angegebenen Werte übereinstimmen muss, mit der Option, das Drop-down-Menü auszublenden.

// 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 zulässiger Werte.
`showDropdown`	`Boolean`	`true`, wenn die Tabelle ein Drop-down-Menü für die Werte enthalten soll; andernfalls `false`.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireValueInRange(range)`

Legt die Datenvalidierungsregel so 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.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`requireValueInRange(range, showDropdown)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss, wobei das Drop-down-Menü ausgeblendet werden kann.

// 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 enthalten soll; andernfalls `false`.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`setAllowInvalid(allowInvalidData)`

Legt fest, ob eine Warnung angezeigt wird, wenn die Eingabe die Datenvalidierung nicht besteht oder ob die Eingabe vollständig 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, andernfalls `false`.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`setHelpText(helpText)`

Legt den Hilfetext fest, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle bewegt, für die die Datenvalidierung festgelegt ist.

Parameter

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

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten

`withCriteria(criteria, args)`

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

// 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`	Die Art der Datenvalidierungskriterien.
`args`	`Object[]`	Ein Array von Argumenten, die dem Kriterientyp entsprechen. Die Anzahl der Argumente und ihr Typ entsprechen der entsprechenden Methode `require...()` oben.

Zurücksenden

DataValidationBuilder: Dieser Builder zum Verketten