ERROR_MESSAGE (Transact-SQL)

Статья
12/15/2008

Возвращает текст сообщения об ошибке, которая возникла в блоке CATCH конструкции TRY…CATCH при выполнении.

Синтаксис

ERROR_MESSAGE()

Типы возвращаемых данных

nvarchar(2048)

Возвращаемое значение

При вызове в блоке CATCH возвращает полный текст сообщения об ошибке, запустившей блок CATCH. Текст содержит значения подставляемых параметров, таких как длина, имена объектов или время.

Возвращает значение NULL в случае вызова вне блока CATCH.

Замечания

Функция ERROR_MESSAGE может быть вызвана в любом месте области блока CATCH.

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

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

Примеры

А. Использование функции ERROR_MESSAGE в блоке CATCH

В коде следующего примера приведена инструкция SELECT, вызывающая ошибку деления на ноль. Возвращается сообщение об ошибке.

USE AdventureWorks;
GO

BEGIN TRY
    -- Generate a divide-by-zero error.
    SELECT 1/0;
END TRY
BEGIN CATCH
    SELECT ERROR_MESSAGE() AS ErrorMessage;
END CATCH;
GO

Б. Использование функции ERROR_MESSAGE в блоке CATCH с другими средствами обработки ошибок

В коде следующего примера приведена инструкция SELECT, вызывающая ошибку деления на ноль. Вместе с сообщением об ошибке возвращаются сведения, имеющие отношение к ней.

USE AdventureWorks;
GO

BEGIN TRY
    -- Generate a divide-by-zero error.
    SELECT 1/0;
END TRY
BEGIN CATCH
    SELECT
        ERROR_NUMBER() AS ErrorNumber,
        ERROR_SEVERITY() AS ErrorSeverity,
        ERROR_STATE() AS ErrorState,
        ERROR_PROCEDURE() AS ErrorProcedure,
        ERROR_LINE() AS ErrorLine,
        ERROR_MESSAGE() AS ErrorMessage;
END CATCH;
GO

См. также

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

ERROR_MESSAGE (Transact-SQL)

Синтаксис

Типы возвращаемых данных

Возвращаемое значение

Замечания

Примеры

А. Использование функции ERROR_MESSAGE в блоке CATCH

Б. Использование функции ERROR_MESSAGE в блоке CATCH с другими средствами обработки ошибок

См. также

Справочник

Другие ресурсы

Справка и поддержка

Дополнительные ресурсы