ERROR_PROCEDURE (Transact-SQL)

發行項
03/07/2014

傳回發生錯誤造成執行 TRY…CATCH 建構的 CATCH 區塊之預存程序或觸發程序的名稱。

適用於：SQL Server (SQL Server 2008 透過目前版本)、Windows Azure SQL 資料庫 (初始版本，透過目前版本)。

語法

ERROR_PROCEDURE ( )

傳回類型

nvarchar(128)

傳回值

在 CATCH 區塊中呼叫時，會傳回發生錯誤的預存程序名稱。

如果未在預存程序或觸發程序內發生錯誤，便傳回 NULL。

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

備註

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

ERROR_PROCEDURE 會傳回發生錯誤的預存程序或觸發程序的名稱，不論呼叫它的次數為何，或是在 CATCH 區塊範圍內的什麼位置呼叫它，都是如此。這有別於 @@ERROR 之類的函數，它們會在緊接於發生錯誤的陳述式之後的陳述式中，或在 CATCH 區塊的第一個陳述式中，傳回錯誤號碼。

在巢狀 CATCH 區塊中，ERROR_PROCEDURE 會傳回參考它的 CATCH 區塊範圍專用的預存程序或觸發程序的名稱。例如，TRY…CATCH 建構的 CATCH 區塊可能會有巢狀的 TRY…CATCH。在巢狀 CATCH 區塊內，ERROR_PROCEDURE 會傳回發生叫用巢狀 CATCH 區塊之錯誤的預存程序或觸發程序名稱。如果 ERROR_PROCEDURE 是在外部 CATCH 區塊中執行，它會傳回發生叫用該 CATCH 區塊的錯誤之預存程序或觸發程序的名稱。

範例

A.在 CATCH 區塊中使用 ERROR_PROCEDURE

下列程式碼範例會顯示產生除以零的錯誤之預存程序。 ERROR_PROCEDURE 會傳回錯誤發生所在之預存程序的名稱。

-- 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_PROCEDURE() AS ErrorProcedure;
END CATCH;
GO

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

下列程式碼範例會顯示產生除以零的錯誤之預存程序。它會傳回發生錯誤的預存程序的名稱，以及錯誤的相關資訊。

-- 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_NUMBER() AS ErrorNumber,
        ERROR_SEVERITY() AS ErrorSeverity,
        ERROR_STATE() AS ErrorState,
        ERROR_PROCEDURE() AS ErrorProcedure,
        ERROR_MESSAGE() AS ErrorMessage,
        ERROR_LINE() AS ErrorLine;
        END CATCH;
GO