• 项目

ERROR_NUMBER (Transact-SQL)

返回错误的错误号，该错误会导致运行 TRY…CATCH 结构的 CATCH 块。

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

语法

ERROR_NUMBER ( )

返回类型

int

返回值

在 CATCH 块中调用时，返回导致运行 CATCH 块的错误消息的错误号。

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

注释

可以在 CATCH 块的作用域内的任何位置调用此函数。

不管在 CATCH 块的作用域内运行的次数和位置，ERROR_NUMBER 都返回错误号。这与 @@ERROR 不同，后者只在紧跟导致错误的语句的语句中或 CATCH 块的第一个语句中返回错误号。

在嵌套的 CATCH 块中，ERROR_NUMBER 返回特定于其被引用的 CATCH 块作用域的错误号。例如，外部 TRY...CATCH 构造的 CATCH 块可能具有嵌套 TRY...CATCH 构造。在嵌套的 CATCH 块中，ERROR_NUMBER 返回调用嵌套的 CATCH 块的错误的编号。如果 ERROR_NUMBER 在外部 CATCH 块中运行，则返回调用此 CATCH 块的错误的编号。

示例

A. 在 CATCH 块中使用 ERROR_NUMBER

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

USE AdventureWorks2008R2;
GO

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

B. 在包含其他错误处理工具的 CATCH 块中使用 ERROR_NUMBER

下面的代码示例显示生成被零除错误的 SELECT 语句。返回错误号的同时，还将返回与错误相关的信息。

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