Using PRINT

Instrukcja PRINT jest używane do zwracania wiadomości do aplikacji.PRINT Trwa znaku lub wyrażenie tekstowego Unicode jako parametr i zwraca ciąg znaków jako wiadomość do aplikacji.Wiadomość jest zwracana jako informacyjne błąd do aplikacji za pomocą SQLClient obszaru nazw lub programowania aplikacji ActiveX Data Objects (ADO), OLE DB i Open Database Connectivity (ODBC) interfejsy (API).Jest SQLSTATE zestaw 01000, błąd macierzysty jest zestaw 0, a komunikat o błędzie jest ciąg zestaw do ciągu określonego w instrukcja PRINT.Do funkcja wywołania zwrotnego obsługi wiadomości w aplikacjach biblioteki DB zostanie zwrócony ciąg.

Instrukcja PRINT akceptuje dowolnego wyrażenie ciągu znaków, włączając znak Unicode stałych, znak lub nazwa zmiennej lokalnej Unicode lub funkcja, której wynikiem jest znak lub ciąg Unicode.PRINT może również stanowić złożonych ciągi wbudowane, łącząc dwie lub więcej stałych, zmiennych lokalnych lub funkcji.

Aby pomóc w rozwiązywaniu problemów za pomocą PRINT Transact-SQL kod, sprawdź wartości danych lub generowanie raportów.

W poniższym przykładzie użyto PRINT wewnątrz IF instrukcja zwraca komunikat o błędzie, gdy jest to liczba z Hex Nut 17 produkt spadnie poniżej 1100.

USE AdventureWorks;
GO
IF (SELECT SUM(i.Quantity)
    FROM Production.ProductInventory i
    JOIN Production.Product p 
    ON i.ProductID = p.ProductID
    WHERE Name = 'Hex Nut 17'
    ) < 1100
    PRINT N'There are less than 1100 units of Hex Nut 17 in stock.'
GO

W poniższym przykładzie drukuje kombinacji zmiennej lokalnej, funkcje systemowe i ciąg tekstowego za pomocą łączenie.

USE AdventureWorks;
GO
DECLARE @MyObject NVARCHAR(257);

SET @MyObject = N'Production.Product';

PRINT N'Object Name: ' + @MyObject
PRINT N'   Object ID: ' + STR(OBJECT_ID(@MyObject))
GO

W poniższym przykładzie przedstawiono dwa sposoby budowania drukowania wiadomości poprzez konkatenację ciągów.

-- Build a print message by concatenating strings in a PRINT
-- statement.
PRINT N'The Database Engine instance '
    + RTRIM(@@SERVERNAME)
    + N' is running SQL Server build '
    + RTRIM(CAST(SERVERPROPERTY(N'ProductVersion ') AS NVARCHAR(128)));
GO
-- This shows building a character variable that is used to
-- print a message.
DECLARE @Msg NVARCHAR(300);

SELECT @Msg = N'The Database Engine instance '
    + RTRIM(@@SERVERNAME)
    + N' is running SQL Server build '
    + RTRIM(CAST(SERVERPROPERTY(N'ProductVersion') AS NVARCHAR(128)));

PRINT @Msg;
GO