CustomFunctions.Error class
Verwenden Sie diese Klasse, um Fehler zu behandeln und benutzerdefinierte Fehlermeldungen zu schreiben.
Hinweise
[ API-Satz: CustomFunctionsRuntime 1.2 ]
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]];
};
Konstruktoren
(constructor)(code, message) | Erstellt eine neue instance der |
Eigenschaften
code | Der von Ihrer benutzerdefinierten Funktion zurückgegebene Fehlercode. |
message | Ihre benutzerdefinierte Fehlermeldung, z. B. "Dieser Aktienkurs ist nicht verfügbar". Benutzerdefinierte Meldungen sind nur mit bestimmten Fehlercodes verfügbar. |
Details zum Konstruktor
(constructor)(code, message)
Erstellt eine neue instance der Error
-Klasse
constructor(code: ErrorCode, message?: string);
Parameter
- message
-
string
Details zur Eigenschaft
code
Der von Ihrer benutzerdefinierten Funktion zurückgegebene Fehlercode.
code: ErrorCode;
Eigenschaftswert
Hinweise
message
Ihre benutzerdefinierte Fehlermeldung, z. B. "Dieser Aktienkurs ist nicht verfügbar". Benutzerdefinierte Meldungen sind nur mit bestimmten Fehlercodes verfügbar.
message?: string;
Eigenschaftswert
string
Hinweise
Office Add-ins