ERROR_LINE (Transact-SQL)

返回发生错误的行号,该错误导致运行 TRY…CATCH 构造的 CATCH 块。

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

语法

ERROR_LINE ( )

返回类型

int

返回值

当在 CATCH 块中调用时:

  • 返回发生错误的行号。

  • 如果错误发生在存储过程或触发器中,则返回例程中的行号。

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

注释

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

ERROR_LINE 返回发生错误的行号,而不考虑它被调用的次数或在 CATCH 块的作用域内被调用的位置。它与 @@ERROR 之类的函数不同,后者会在导致错误的语句之后的语句中立即返回错误号,或在 CATCH 块的第一个语句中返回错误号。

在嵌套 CATCH 块中,ERROR_LINE 返回特定于引用它的 CATCH 块作用域的错误行号。例如,TRY…CATCH 构造的 CATCH 块可以包含一个嵌套 TRY…CATCH 构造。在嵌套 CATCH 块中,ERROR_LINE 返回调用嵌套 CATCH 块的错误的行号。如果 ERROR_LINE 在 CATCH 块以外运行,则会返回调用该 CATCH 块的错误的行号。

示例

A. 在 CATCH 块中使用 ERROR_LINE

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

USE AdventureWorks2008R2;
GO

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

B. 带存储过程在 CATCH 块中使用 ERROR_LINE

下面的代码示例演示一个生成被零除错误的存储过程。ERROR_LINE 返回发生错误的存储过程中的行号。

-- Verify that the stored procedure does not already exist.
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL 
    DROP PROCEDURE usp_ExampleProc;
GO

-- Create a stored procedure that 
-- generates a divide-by-zero error.
CREATE PROCEDURE usp_ExampleProc
AS
    SELECT 1/0;
GO

BEGIN TRY
    -- Execute the stored procedure inside the TRY block.
    EXECUTE usp_ExampleProc;
END TRY
BEGIN CATCH
    SELECT ERROR_LINE() AS ErrorLine;
END CATCH;
GO

C. 带其他错误处理工具在 CATCH 块中使用 ERROR_LINE

下面的代码示例显示生成被零除错误的 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