ExcelScript.DataValidation interface

Stellt die Datenüberprüfung dar, die auf den aktuellen Bereich angewendet wird.

Methoden

clear()

Löscht die Datenüberprüfung aus dem aktuellen Bereich.

getErrorAlert()

Fehlermeldung, wenn Benutzer ungültige Daten eingibt.

getIgnoreBlanks()

Gibt an, ob die Datenüberprüfung für leere Zellen durchgeführt wird. Der Standardwert ist true.

getInvalidCells()

Gibt ein RangeAreas Objekt zurück, das einen oder mehrere rechteckige Bereiche mit ungültigen Zellwerten umfasst. Wenn alle Zellwerte gültig sind, gibt diese Funktion null.

getPrompt()

Eingabeaufforderung, wenn Benutzer eine Zelle auswählen.

getRule()

Datenüberprüfungsregel, die unterschiedliche Typen von Datenüberprüfungskriterien enthält.

getType()

Den Typ der Datenüberprüfung finden Sie unter ExcelScript.DataValidationType Details .

getValid()

Gibt an, ob alle Zellwerte entsprechend den Datenüberprüfungsregeln gültig sind. Gibt true zurück, ob alle Zellwerte gültig sind oder false wenn alle Zellwerte ungültig sind. Gibt null zurück, ob sowohl gültige als auch ungültige Zellwerte innerhalb des Bereichs vorhanden sind.

setErrorAlert(errorAlert)

Fehlermeldung, wenn Benutzer ungültige Daten eingibt.

setIgnoreBlanks(ignoreBlanks)

Gibt an, ob die Datenüberprüfung für leere Zellen durchgeführt wird. Der Standardwert ist true.

setPrompt(prompt)

Eingabeaufforderung, wenn Benutzer eine Zelle auswählen.

setRule(rule)

Datenüberprüfungsregel, die unterschiedliche Typen von Datenüberprüfungskriterien enthält.

Details zur Methode

clear()

Löscht die Datenüberprüfung aus dem aktuellen Bereich.

clear(): void;

Gibt zurück

void

getErrorAlert()

Fehlermeldung, wenn Benutzer ungültige Daten eingibt.

getErrorAlert(): DataValidationErrorAlert;

Gibt zurück

getIgnoreBlanks()

Gibt an, ob die Datenüberprüfung für leere Zellen durchgeführt wird. Der Standardwert ist true.

getIgnoreBlanks(): boolean;

Gibt zurück

boolean

getInvalidCells()

Gibt ein RangeAreas Objekt zurück, das einen oder mehrere rechteckige Bereiche mit ungültigen Zellwerten umfasst. Wenn alle Zellwerte gültig sind, gibt diese Funktion null.

getInvalidCells(): RangeAreas;

Gibt zurück

getPrompt()

Eingabeaufforderung, wenn Benutzer eine Zelle auswählen.

getPrompt(): DataValidationPrompt;

Gibt zurück

getRule()

Datenüberprüfungsregel, die unterschiedliche Typen von Datenüberprüfungskriterien enthält.

getRule(): DataValidationRule;

Gibt zurück

getType()

Den Typ der Datenüberprüfung finden Sie unter ExcelScript.DataValidationType Details .

getType(): DataValidationType;

Gibt zurück

Beispiele

/**
 * This sample reads and logs the data validation type of the currently selected range.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the currently selected range.
  let range = workbook.getSelectedRange();

  // Get the type (`DataValidationType`) of data validation applied to the range.
  let validationType = range.getDataValidation().getType();

  /*
   * Log the data validation type.
   * If the range has a single value, it logs that type.
   * If the range doesn't have data validation applied, it logs "None".
   * If the range has multiple different types of data validation, it logs "Inconsistent" or "MixedCriteria".
   */
  console.log(validationType.toString());
}

getValid()

Gibt an, ob alle Zellwerte entsprechend den Datenüberprüfungsregeln gültig sind. Gibt true zurück, ob alle Zellwerte gültig sind oder false wenn alle Zellwerte ungültig sind. Gibt null zurück, ob sowohl gültige als auch ungültige Zellwerte innerhalb des Bereichs vorhanden sind.

getValid(): boolean;

Gibt zurück

boolean

setErrorAlert(errorAlert)

Fehlermeldung, wenn Benutzer ungültige Daten eingibt.

setErrorAlert(errorAlert: DataValidationErrorAlert): void;

Parameter

Gibt zurück

void

setIgnoreBlanks(ignoreBlanks)

Gibt an, ob die Datenüberprüfung für leere Zellen durchgeführt wird. Der Standardwert ist true.

setIgnoreBlanks(ignoreBlanks: boolean): void;

Parameter

ignoreBlanks

boolean

Gibt zurück

void

setPrompt(prompt)

Eingabeaufforderung, wenn Benutzer eine Zelle auswählen.

setPrompt(prompt: DataValidationPrompt): void;

Parameter

Gibt zurück

void

setRule(rule)

Datenüberprüfungsregel, die unterschiedliche Typen von Datenüberprüfungskriterien enthält.

setRule(rule: DataValidationRule): void;

Parameter

Gibt zurück

void