Поделиться через


CustomFunctions.ErrorCode enum

Коды ошибок для пользовательских функций. Коды ошибок появятся в ячейке, в которую была вызвана функция.

В дополнение к этим кодам ошибок отображаются пользовательские сообщения об ошибках. Пользовательские сообщения отображаются в меню индикатора ошибок, доступ к которому осуществляется путем наведении указателя мыши на флаг ошибки в каждой ячейке с ошибкой.

Комментарии

Примеры

/**
 * 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]];
  };

Поля

divisionByZero = "#DIV/0!"

Этот код ошибки указывает, что используемая функция делится на ноль или пустые ячейки. Не удается использовать пользовательское сообщение об ошибке.

invalidName = "#NAME?"

Этот код ошибки указывает, что в имени функции есть опечатка. Обратите внимание, что этот код ошибки поддерживается как ошибка ввода пользовательской функции, но не как ошибка вывода пользовательской функции. Не удается использовать пользовательское сообщение об ошибке.

invalidNumber = "#NUM!"

Этот код ошибки указывает на наличие проблемы с числом в функции. Не удается использовать пользовательское сообщение об ошибке.

invalidReference = "#REF!"

Этот код ошибки указывает, что функция ссылается на недопустимую ячейку. Обратите внимание, что этот код ошибки поддерживается как ошибка ввода пользовательской функции, но не как ошибка вывода пользовательской функции. Не удается использовать пользовательское сообщение об ошибке.

invalidValue = "#VALUE!"

Этот код ошибки указывает, что значение в функции имеет неправильный тип данных. При необходимости в дополнение к коду ошибки можно использовать пользовательское сообщение об ошибке.

notAvailable = "#N/A"

Этот код ошибки указывает, что функция или служба недоступны. При необходимости в дополнение к коду ошибки можно использовать пользовательское сообщение об ошибке.

nullReference = "#NULL!"

Этот код ошибки указывает, что диапазоны в функции не пересекаются. Не удается использовать пользовательское сообщение об ошибке.