ERROR_NUMBER (Transact-SQL)

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric 的 SQL 端點分析 Microsoft Fabric 的倉儲

此函式會傳回造成執行 TRY...CATCH 建構的 CATCH 區塊之錯誤的錯誤號碼。

Transact-SQL 語法慣例

語法

ERROR_NUMBER ( )  

傳回型別

int

傳回值

在 CATCH 區塊中呼叫時，ERROR_NUMBER 會傳回造成執行 CATCH 區塊之錯誤的錯誤號碼。

在 CATCH 區塊範圍之外呼叫時，ERROR_NUMBER 會傳回 NULL。

備註

ERROR_NUMBER 支援在 CATCH 區塊範圍內的任何位置呼叫。

不論執行多少次，或在 CATCH 區塊範圍內的哪個位置執行，ERROR_NUMBER 都會傳回相關的錯誤號碼。 這有別於 @@ERROR 之類的函式，其只會在緊接於發生錯誤的陳述式之後的陳述式中，傳回錯誤號碼。

在巢狀 CATCH 區塊中，ERROR_NUMBER 會參考該 CATCH 區塊之 CATCH 區塊範圍特定的錯誤號碼。 例如，外部 TRY...CATCH 建構的 CATCH 區塊可能會有內部 TRY...CATCH 建構。 在該內部 CATCH 區塊內，ERROR_NUMBER 會傳回叫用內部 CATCH 區塊之錯誤的號碼。 如果 ERROR_NUMBER 是在外部 CATCH 區塊中執行，它會傳回叫用該外部 CATCH 區塊之錯誤的號碼。

範例

A. 在 CATCH 區塊中使用 ERROR_NUMBER

此範例會顯示產生除以零之錯誤的 SELECT 陳述式。 CATCH 區塊會傳回錯誤號碼。

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

結果集如下所示。

-----------

(0 row(s) affected)

ErrorNumber
-----------
8134

(1 row(s) affected)

B. 在含有其他錯誤處理工具的 CATCH 區塊中使用 ERROR_NUMBER

此範例會顯示產生除以零之錯誤的 SELECT 陳述式。 除了錯誤號碼，CATCH 區塊也會傳回該錯誤的相關資訊。

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  

結果集如下所示。

-----------

(0 row(s) affected)

ErrorNumber ErrorSeverity ErrorState  ErrorProcedure   ErrorLine  ErrorMessage
----------- ------------- ----------- ---------------  ---------- ----------------------------------
8134        16            1           NULL             4          Divide by zero error encountered.

(1 row(s) affected)

另請參閱

sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL)
ERROR_SEVERITY (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
錯誤和事件參考 (Database Engine)