共用方式為


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

請參閱

參考

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)