PRINT (Transact-SQL)

向用戶端傳回使用者自訂訊息。

語法

PRINT msg_str | @local_variable | string_expr

引數

msg_str

這是一個字元字串或 Unicode 字串常數。如需詳細資訊,請參閱<常數 (Transact-SQL)>。

@local_variable

這是任何有效字元資料類型的變數。@local_variable 必須是 charvarchar,否則,它必須能夠隱含地轉換成這些資料類型。

string_expr

這是傳回字串的運算式。它可以包括串連的常值、函數和變數。訊息字串的長度最多可有 8,000 個字元;8,000 之後的任何字元都會被截斷。如需詳細資訊,請參閱<運算式 (Transact-SQL)>。

備註

如需有關應用程式如何處理 PRINT 陳述式傳回之訊息的資訊,請參閱<處理應用程式中的錯誤和訊息>。

RAISERROR 也可用來傳回訊息。相較於 PRINT,RAISERROR 有下列優點:

  • RAISERROR 支援利用以 C 語言標準程式庫 printf 函數為基礎來建立型模的機制,將引數代入錯誤訊息中。
  • 除了文字訊息之外,RAISERROR 還可以指定唯一錯誤號碼、嚴重性和狀態碼。
  • RAISERROR 可用來傳回利用 sp_addmessage 系統預存程序建立的使用者自訂訊息。

範例

A. 有條件地執行列印 (IF EXISTS)

這個範例會利用 PRINT 陳述式,有條件地傳回訊息。

IF @@OPTIONS & 512 <> 0
    PRINT N'This user has SET NOCOUNT turned ON.';
ELSE
    PRINT N'This user has SET NOCOUNT turned OFF.';
GO

B. 建立和顯示字串

這個範例會將 GETDATE 函數的結果轉換成 varchar 資料類型,且會將它和 PRINT 將傳回的常值文字串連起來。

-- Build the message text by concatenating
-- strings and expressions using functionality
-- available in SQL Server 2000 and SQL Server 2005.
PRINT N'This message was printed on '
    + RTRIM(CAST(GETDATE() AS NVARCHAR(30)))
    + N'.';
GO
-- This example shows building the message text
-- in a variable and then passing it to PRINT.
-- This was required in SQL Server 7.0 or earlier.
DECLARE @PrintMessage NVARCHAR(50);
SET @PrintMessage = N'This message was printed on '
    + RTRIM(CAST(GETDATE() AS NVARCHAR(30)))
    + N'.';
PRINT @PrintMessage;
GO

請參閱

參考

資料類型 (Transact-SQL)
DECLARE @local\_variable (Transact-SQL)
RAISERROR (Transact-SQL)

其他資源

使用 PRINT
使用 RAISERROR

說明及資訊

取得 SQL Server 2005 協助