發行項
09/24/2010

ERROR_STATE (Transact-SQL)

傳回造成執行 TRY…CATCH 建構的 CATCH 區塊之錯誤的狀態碼。

語法

ERROR_STATE ( )

傳回類型

int

傳回值

當它在 CATCH 區塊中被呼叫時，會傳回造成執行 CATCH 區塊之錯誤訊息的狀態碼。

如果是在 CATCH 區塊範圍之外呼叫，便傳回 NULL。

備註

對於 MicrosoftSQL ServerDatabase Engine 來說，程式碼有多個點都可能會產生某些錯誤訊息。例如，在許多不同情況下，都有可能產生 "1105" 錯誤。每個產生錯誤的特定狀況，都會指派唯一的狀態碼。

當檢視已知問題的資料庫時，例如 Microsoft 知識庫，您可以利用狀態碼來判斷所記錄的問題，與您遇到的錯誤是否相同。例如，如果知識庫文件討論狀態為 2 的 1105 錯誤訊息，而您收到的 1105 錯誤訊息的狀態卻是 3，錯誤原因可能不是文章所報告的原因。

SQL Server 支援工程師也可以利用錯誤中的狀態碼，來找出原始程式碼發生錯誤的位置，這也許能提供如何診斷問題的其他想法。

可以在 CATCH 區塊範圍內的任何位置呼叫 ERROR_STATE。

ERROR_STATE 不論執行多少次，也不論是在 CATCH 區塊範圍內的任何位置執行，都會傳回錯誤狀態。這有別於 @@ERROR，@@ERROR 只會在緊接於發生錯誤的陳述式之後的陳述式中，或在 CATCH 區塊的第一個陳述式中傳回錯誤訊息。

在巢狀 CATCH 區塊中，ERROR_STATE 會傳回參考它的 CATCH 區塊範圍特定的錯誤狀態。例如，外部 TRY...CATCH 建構的 CATCH 區塊可能會有巢狀的 TRY...CATCH 建構。在巢狀 CATCH 區塊內，ERROR_STATE 會從呼叫巢狀 CATCH 區塊的錯誤傳回狀態。如果 ERROR_STATE 是在外部 CATCH 區塊內執行，它會從呼叫 CATCH 區塊的錯誤傳回狀態。

範例

A. 在 CATCH 區塊中使用 ERROR_STATE

下列範例顯示將會產生除以零之錯誤的 SELECT 陳述式。它會傳回錯誤的狀態。

USE AdventureWorks;
GO

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

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

下列範例顯示將會產生除以零之錯誤的 SELECT 陳述式。錯誤的相關訊息會隨同錯誤狀態一起傳回。

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