ERROR_SEVERITY (Transact-SQL)
傳回造成執行 TRY…CATCH 建構的 CATCH 區塊之錯誤的嚴重性。
語法
ERROR_SEVERITY()
傳回類型
int
傳回值
當它在 CATCH 區塊中被呼叫時,會傳回造成執行 CATCH 區塊之錯誤訊息的嚴重性。
如果是在 CATCH 區塊範圍之外呼叫,便傳回 NULL。
備註
可以在 CATCH 區塊範圍內的任何位置呼叫 ERROR_SEVERITY。
ERROR_SEVERITY 不論它執行多少次,也不論是在 CATCH 區塊範圍內的任何位置執行,都會傳回錯誤嚴重性。這有別於 @@ERROR,@@ERROR 只會在緊接於發生錯誤的陳述式之後的陳述式中,或在 CATCH 區塊的第一個陳述式中傳回錯誤訊息。
在巢狀 CATCH 區塊中,ERROR_SEVERITY 會傳回參考它的 CATCH 區塊範圍特定的錯誤嚴重性。例如,外部 TRY...CATCH 建構的 CATCH 區塊可能會有巢狀的 TRY...CATCH 建構。在巢狀 CATCH 區塊內,ERROR_SEVERITY 會從叫用巢狀 CATCH 區塊的錯誤傳回嚴重性。如果 ERROR_SEVERITY 是在外部 CATCH 區塊中執行,它會從叫用 CATCH 區塊的錯誤傳回嚴重性。
範例
A. 在 CATCH 區塊中使用 ERROR_SEVERITY
下列程式碼範例會顯示產生除以零的錯誤之 SELECT 陳述式。它會傳回錯誤的嚴重性。
USE AdventureWorks;
GO
BEGIN TRY
-- Generate a divide-by-zero error.
SELECT 1/0;
END TRY
BEGIN CATCH
SELECT ERROR_SEVERITY() AS ErrorSeverity;
END CATCH;
GO
B. 在含有其他錯誤處理工具的 CATCH 區塊中使用 ERROR_SEVERITY
下列程式碼範例會顯示產生除以零的錯誤之 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
請參閱
參考
sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_NUMBER (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
其他資源
在 Transact-SQL 中擷取錯誤資訊
Database Engine 錯誤嚴重性
在 Transact-SQL 中使用 TRY...CATCH
使用 RAISERROR
使用 @@ERROR