CustomFunctions.ErrorCode enum

  • Referenz
Paket:
custom-functions-runtime

Fehlercodes für benutzerdefinierte Funktionen. Die Fehlercodes werden in der Zelle angezeigt, die die Funktion aufgerufen hat.

Zusätzlich zu diesen Fehlercodes werden benutzerdefinierte Fehlermeldungen angezeigt. Benutzerdefinierte Meldungen werden im Fehlerindikatormenü angezeigt, auf das zugegriffen wird, indem auf jede Zelle mit einem Fehler auf das Fehlerflag gezeigt wird.

Hinweise

Beispiele

/**
 * Returns the #NUM! error as part of a 2-dimensional array.
 * @customfunction
 * @param {number} first First parameter.
 * @param {number} second Second parameter.
 * @param {number} third Third parameter.
 * @returns {number[][]} Three results, as a 2-dimensional array.
 */
function returnInvalidNumberError(first, second, third) {
  // Use the `CustomFunctions.Error` object to retrieve an invalid number error.
  const error = new CustomFunctions.Error(
    CustomFunctions.ErrorCode.invalidNumber, // Corresponds to the #NUM! error in the Excel UI.
  );

  // Enter logic that processes the first, second, and third input parameters.
  // Imagine that the second calculation results in an invalid number error.
  const firstResult = first;
  const secondResult = error;
  const thirdResult = third;

  // Return the results of the first and third parameter calculations
  // and a #NUM! error in place of the second result.
  return [[firstResult], [secondResult], [thirdResult]];
  };

Felder

divisionByZero = "#DIV/0!"

Dieser Fehlercode gibt an, dass die verwendete Funktion durch null oder leere Zellen dividiert wird. Eine benutzerdefinierte Fehlermeldung kann nicht verwendet werden.
invalidName = "#NAME?"

Dieser Fehlercode gibt an, dass der Funktionsname einen Tippfehler enthält. Beachten Sie, dass dieser Fehlercode als benutzerdefinierter Funktionseingabefehler unterstützt wird, aber nicht als benutzerdefinierter Funktionsausgabefehler. Eine benutzerdefinierte Fehlermeldung kann nicht verwendet werden.
invalidNumber = "#NUM!"

Dieser Fehlercode gibt an, dass ein Problem mit einer Zahl in der Funktion vorliegt. Eine benutzerdefinierte Fehlermeldung kann nicht verwendet werden.
invalidReference = "#REF!"

Dieser Fehlercode gibt an, dass die Funktion auf eine ungültige Zelle verweist. Beachten Sie, dass dieser Fehlercode als benutzerdefinierter Funktionseingabefehler unterstützt wird, aber nicht als benutzerdefinierter Funktionsausgabefehler. Eine benutzerdefinierte Fehlermeldung kann nicht verwendet werden.
invalidValue = "#VALUE!"

Dieser Fehlercode gibt an, dass ein Wert in der Funktion den falschen Datentyp aufweist. Bei Bedarf kann zusätzlich zum Fehlercode eine benutzerdefinierte Fehlermeldung verwendet werden.
notAvailable = "#N/A"

Dieser Fehlercode gibt an, dass die Funktion oder der Dienst nicht verfügbar ist. Bei Bedarf kann zusätzlich zum Fehlercode eine benutzerdefinierte Fehlermeldung verwendet werden.
nullReference = "#NULL!"

Dieser Fehlercode gibt an, dass sich die Bereiche in der Funktion nicht überschneiden. Eine benutzerdefinierte Fehlermeldung kann nicht verwendet werden.