Partager via


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 s’affichent en plus de ces codes d’erreur. Les messages personnalisés s’affichent dans le menu de l’indicateur d’erreur, accessible en pointant sur l’indicateur d’erreur sur chaque cellule avec 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 divisée par zéro ou par des cellules vides. Un message d’erreur personnalisé ne peut pas être utilisé.

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. Un message d’erreur personnalisé ne peut pas être utilisé.

invalidNumber = "#NUM!"

Ce code d’erreur indique qu’il existe un problème avec un nombre dans la fonction . Un message d’erreur personnalisé ne peut pas être utilisé.

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. Un message d’erreur personnalisé ne peut pas être utilisé.

invalidValue = "#VALUE!"

Ce code d’erreur indique qu’une valeur de la fonction est du 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 croisent pas. Un message d’erreur personnalisé ne peut pas être utilisé.