Share via


RETURN (Transact-SQL)

無條件地結束查詢或程序。 RETURN 是立即而完整的,您隨時可以利用它來結束程序、批次或陳述式區塊。 系統不會執行 RETURN 之後的陳述式。

主題連結圖示 Transact-SQL 語法慣例

語法

RETURN [ integer_expression ] 

引數

  • integer_expression
    這是傳回的整數值。 預存程序可以向發出呼叫的程序或應用程式傳回一個整數值。

傳回類型

選擇性地傳回 int。

[!附註]

除非另有說明,否則所有系統預存程序都會傳回 0 值。 這表示成功,而非零值則表示失敗。

備註

當搭配預存程序來使用時,RETURN 無法傳回 Null 值。 如果程序嘗試傳回 Null 值 (例如,當 @status 是 NULL 時,使用 RETURN @status),便會產生一則警告訊息,而且會傳回 0 值。

您可以將傳回狀態值包括在批次或程序內執行目前程序的後續 Transact-SQL 陳述式之中,不過,您必須依照下列格式來輸入它:EXECUTE @return\_status = <procedure_name>。

範例

A.從程序傳回

下列範例會顯示當執行 findjobs 時,如果未在參數中指定任何使用者名稱,RETURN 會在訊息傳給使用者畫面之後,使程序結束。 如果指定了使用者名稱,便會從適當的系統資料表中,擷取這位使用者在目前資料庫中所建立之所有物件的名稱。

CREATE PROCEDURE findjobs @nm sysname = NULL
AS 
IF @nm IS NULL
    BEGIN
        PRINT 'You must give a user name'
        RETURN
    END
ELSE
    BEGIN
        SELECT o.name, o.id, o.uid
        FROM sysobjects o INNER JOIN master..syslogins l
            ON o.uid = l.sid
        WHERE l.name = @nm
    END;

B.傳回狀態碼

下列範例會檢查指定連絡人之識別碼的州/省份。 如果是華盛頓州 (WA),傳回的狀態就是 1。 任何其他狀況 (StateProvince 值不是 WA,或 ContactID 沒有相符的資料列) 都會傳回 2。

USE AdventureWorks2012;
GO
CREATE PROCEDURE checkstate @param varchar(11)
AS
IF (SELECT StateProvince FROM Person.vAdditionalContactInfo WHERE ContactID = @param) = 'WA'
    RETURN 1
ELSE
    RETURN 2;
GO

下列範例會顯示執行 checkstate 的傳回狀態。 首先顯示在華盛頓州的連絡人,其次顯示不在華盛頓州的連絡人,之後,顯示無效的連絡人。 您必須先宣告 @return\_status 本機變數,才能使用它。

DECLARE @return_status int;
EXEC @return_status = checkstate '2';
SELECT 'Return Status' = @return_status;
GO

以下為結果集:

Return Status

-------------

1

指定不同的連絡號碼來重新執行查詢。

DECLARE @return_status int;
EXEC @return_status = checkstate '6';
SELECT 'Return Status' = @return_status;
GO

以下為結果集:

Return Status

-------------

2

指定另一個連絡號碼來重新執行查詢。

DECLARE @return_status int
EXEC @return_status = checkstate '12345678901';
SELECT 'Return Status' = @return_status;
GO

以下為結果集:

Return Status

-------------

2

請參閱

參考

ALTER PROCEDURE (Transact-SQL)

CREATE PROCEDURE (Transact-SQL)

DECLARE @local\_variable (Transact-SQL)

EXECUTE (Transact-SQL)

SET @local\_variable (Transact-SQL)