CustomFunctions.ErrorCode enum
Codes d’erreur pour les fonctions personnalisées. Les codes d’erreur s’affichent dans la cellule qui a appelé la fonction.
Des messages d’erreur personnalisés apparaissent en plus de ces codes d’erreur. Les messages personnalisés s’affichent dans le menu indicateur d’erreur, auquel vous pouvez accéder en survolant l’indicateur d’erreur sur chaque cellule comportant une erreur.
Remarques
Exemples
/**
* 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]];
};
Champs
| divisionByZero = "#DIV/0!" | Ce code d’erreur indique que la fonction utilisée est une division par zéro ou des cellules vides. Impossible d’utiliser un message d’erreur personnalisé. |
| invalidName = "#NAME?" | Ce code d’erreur indique qu’il existe une faute de frappe dans le nom de la fonction. Notez que ce code d’erreur est pris en charge en tant qu’erreur d’entrée de fonction personnalisée, mais pas en tant qu’erreur de sortie de fonction personnalisée. Impossible d’utiliser un message d’erreur personnalisé. |
| invalidNumber = "#NUM!" | Ce code d’erreur indique qu’il y a un problème avec un nombre dans la fonction. Impossible d’utiliser un message d’erreur personnalisé. |
| invalidReference = "#REF!" | Ce code d’erreur indique que la fonction fait référence à une cellule non valide. Notez que ce code d’erreur est pris en charge en tant qu’erreur d’entrée de fonction personnalisée, mais pas en tant qu’erreur de sortie de fonction personnalisée. Impossible d’utiliser un message d’erreur personnalisé. |
| invalidValue = "#VALUE!" | Ce code d’erreur indique qu’une valeur de la fonction est d’un type de données incorrect. Un message d’erreur personnalisé peut être utilisé en plus du code d’erreur, si vous le souhaitez. |
| notAvailable = "#N/A" | Ce code d’erreur indique que la fonction ou le service n’est pas disponible. Un message d’erreur personnalisé peut être utilisé en plus du code d’erreur, si vous le souhaitez. |
| nullReference = "#NULL!" | Ce code d’erreur indique que les plages de la fonction ne se coupent pas. Impossible d’utiliser un message d’erreur personnalisé. |