ExcelScript.BasicDataValidation interface

Paket:

ExcelScript

Stellt die grundlegenden Überprüfungskriterien für Typdaten dar.

Hinweise

Beispiele

/**
 * This script creates a data validation rule for the range B1:B5.
 * All values in that range must be a positive number.
 * Attempts to enter other values are blocked and an error message appears.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range B1:B5 in the active worksheet.
  const currentSheet = workbook.getActiveWorksheet();
  const positiveNumberOnlyCells = currentSheet.getRange("B1:B5");

  // Create a data validation rule to only allow positive numbers.
  const positiveNumberValidation: ExcelScript.BasicDataValidation = {
    formula1: "0",
    operator: ExcelScript.DataValidationOperator.greaterThan
  };
  const positiveNumberOnlyRule: ExcelScript.DataValidationRule = {
    wholeNumber: positiveNumberValidation
  };

  // Set the rule on the range.
  const rangeDataValidation = positiveNumberOnlyCells.getDataValidation();
  rangeDataValidation.setRule(positiveNumberOnlyRule);

  // Create an alert to appear when data other than positive numbers are entered.
  const positiveNumberOnlyAlert: ExcelScript.DataValidationErrorAlert = {
    message: "Positive numbers only",
    showAlert: true,
    style: ExcelScript.DataValidationAlertStyle.stop,
    title: "Invalid data"
  };
  rangeDataValidation.setErrorAlert(positiveNumberOnlyAlert);
}

Eigenschaften

formula1	Gibt den rechten Operanden an, wenn die Operatoreigenschaft auf einen binären Operator wie GreaterThan festgelegt ist (der linke Operand ist der Wert, den der Benutzer in die Zelle eingeben möchte). Gibt mit den ternären Operatoren Between und NotBetween den operanden unteren Grenzwert an. Wenn Formel1 beispielsweise auf 10 und Operator auf GreaterThan festgelegt wird, bedeutet dies, dass gültige Daten für den Bereich größer als 10 sein müssen. Beim Festlegen des Werts kann er als Zahl, als Bereichsobjekt oder als Zeichenfolgenformel übergeben werden (wobei die Zeichenfolge entweder eine Zeichenfolgennummer, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.
formula2	Gibt mit den ternären Operatoren Between und NotBetween den oberen Begrenzungsoperanden an. Wird nicht mit den binären Operatoren verwendet, z. B. GreaterThan. Beim Festlegen des Werts kann er als Zahl, als Bereichsobjekt oder als Zeichenfolgenformel übergeben werden (wobei die Zeichenfolge entweder eine Zeichenfolgennummer, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.
operator	Der Operator, der zum Überprüfen der Daten verwendet wird.

Details zur Eigenschaft

formula1

Gibt den rechten Operanden an, wenn die Operatoreigenschaft auf einen binären Operator wie GreaterThan festgelegt ist (der linke Operand ist der Wert, den der Benutzer in die Zelle eingeben möchte). Gibt mit den ternären Operatoren Between und NotBetween den operanden unteren Grenzwert an. Wenn Formel1 beispielsweise auf 10 und Operator auf GreaterThan festgelegt wird, bedeutet dies, dass gültige Daten für den Bereich größer als 10 sein müssen. Beim Festlegen des Werts kann er als Zahl, als Bereichsobjekt oder als Zeichenfolgenformel übergeben werden (wobei die Zeichenfolge entweder eine Zeichenfolgennummer, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.

formula1: string | number | Range;

Eigenschaftswert

string | number | ExcelScript.Range

formula2

Gibt mit den ternären Operatoren Between und NotBetween den oberen Begrenzungsoperanden an. Wird nicht mit den binären Operatoren verwendet, z. B. GreaterThan. Beim Festlegen des Werts kann er als Zahl, als Bereichsobjekt oder als Zeichenfolgenformel übergeben werden (wobei die Zeichenfolge entweder eine Zeichenfolgennummer, ein Zellbezug wie "=A1" oder eine Formel wie "=MIN(A1, B1)") ist. Beim Abrufen des Werts wird er immer als Zeichenfolgenformel zurückgegeben, z. B. "=10", "=A1", "=SUMME(A1:B5)" usw.

formula2?: string | number | Range;

Eigenschaftswert

string | number | ExcelScript.Range

operator

Der Operator, der zum Überprüfen der Daten verwendet wird.

operator: DataValidationOperator;

Eigenschaftswert

ExcelScript.DataValidationOperator