ERROR_MESSAGE (Transact-SQL)

返回导致 TRY…CATCH 构造的 CATCH 块运行的错误的消息文本。

主题链接图标 Transact-SQL 语法约定

语法

ERROR_MESSAGE ( ) 

返回类型

nvarchar(4000)

返回值

在 CATCH 块中调用时,返回导致 CATCH 块运行的错误消息的完整文本。 该文本包括为所有可替换参数提供的值,如长度、对象名或时间。

如果在 CATCH 块作用域以外调用,则返回 NULL。

注释

ERROR_MESSAGE 可以在 CATCH 块作用域内的任意位置调用。

ERROR_MESSAGE 无论运行多少次,无论在 CATCH 块作用域内的什么位置运行,它都返回错误消息。 这与 @@ERROR 之类的函数形成鲜明对比,后者这样的函数只能在紧接导致错误的语句后面的下一个语句中返回错误号,或者在 CATCH 块的第一个语句中返回错误号。

在嵌套 CATCH 块中,ERROR_MESSAGE 返回特定于它被引用 CATCH 块作用域的错误消息。 例如,外部 TRY...CATCH 构造的 CATCH 块可能具有嵌套 TRY...CATCH 构造。 在嵌套 CATCH 块中,ERROR_MESSAGE 返回调用该嵌套 CATCH 块的错误消息。 如果 ERROR_MESSAGE 在外部 CATCH 块中运行,它将返回调用该外部 CATCH 块的错误消息。

示例

A.在 CATCH 块中使用 ERROR_MESSAGE

下面的代码示例显示生成被零除错误的 SELECT 语句。 将返回错误消息。

USE AdventureWorks2012;
GO

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

B.在 CATCH 块中将 ERROR_MESSAGE 与其他错误处理工具一起使用

下面的代码示例显示生成被零除错误的 SELECT 语句。 同时返回错误消息和有关错误的信息。

USE AdventureWorks2012;
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

请参阅

参考

sys.messages (Transact-SQL)

TRY...CATCH (Transact-SQL)

ERROR_LINE (Transact-SQL)

ERROR_NUMBER (Transact-SQL)

ERROR_PROCEDURE (Transact-SQL)

ERROR_SEVERITY (Transact-SQL)

ERROR_STATE (Transact-SQL)

RAISERROR (Transact-SQL)

@@ERROR (Transact-SQL)