發行項
09/24/2010

ERROR_MESSAGE (Transact-SQL)

傳回造成執行 TRY…CATCH 建構的 CATCH 區塊之錯誤的訊息文字。

語法

ERROR_MESSAGE ( )

傳回類型

nvarchar(2048)

傳回值

當它在 CATCH 區塊中被呼叫時，會傳回造成執行 CATCH 區塊之錯誤訊息的完整文字。文字包括提供給任何可替代參數的值，例如，長度、物件名稱或次數。

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

備註

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

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

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

範例

A. 在 CATCH 區塊中使用 ERROR_MESSAGE

下列程式碼範例會顯示產生除以零之錯誤的 SELECT 陳述式。它會傳回錯誤的訊息。

USE AdventureWorks;
GO

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

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

下列程式碼範例會顯示產生除以零之錯誤的 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