ERROR_LINE (Transact-SQL)

项目
05/30/2023

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例

此函数返回出现错误的行号，该错误导致执行了 TRY…CATCH 构造的 CATCH 块。

语法

ERROR_LINE ( )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

返回类型

int

返回值

在 CATCH 块中调用时，ERROR_LINE 返回

出现错误的行号
如果在存储过程或触发器中出现错误，则返回例程中的行号
如果在 CATCH 块作用域外调用，则返回 NULL。

注解

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

ERROR_LINE 返回出现错误的行号。无论在 CATCH 块作用域内的任何位置调用 ERROR_LINE，以及无论调用 ERROR_LINE 多少次，都会发生这种情况。这与函数不同，例如 @@ERROR。 @@ERROR 在导致错误的语句的后一个语句中或 CATCH 块的第一个语句中返回错误号。

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

示例

A. 在 CATCH 块中使用 ERROR_LINE

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

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 语句。 ERROR_LINE 返回出现错误的行号，以及与错误本身相关的信息。

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

另请参阅

TRY...CATCH (Transact-SQL)
sys.messages (Transact-SQL)
ERROR_NUMBER (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL)
ERROR_SEVERITY (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)