Share via

  • Artykuł

Drukuj (Transact-SQL)

Zwraca komunikat zdefiniowane przez użytkownika do klient.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

PRINT msg_str | @local_variable | string_expr

Argumenty

  • msg_str
    Jest to ciąg znaków lub Unicode ciąg stała.Aby uzyskać więcej informacji, zobacz Stałe (Transact-SQL).

  • **@local_variable
    Jest zmienna dowolnego typu danych prawidłowych znaków.    @**local_variable musi być char, nchar, varchar, lub nvarchar, lub musi być w stanie są niejawnie konwertowane na te typy danych.

  • string_expr
    To wyrażenie , które zwraca ciąg.Można dołączyć uzyskiwanej wartości literałów, funkcji i zmiennych.Aby uzyskać więcej informacji, zobacz Wyrażenia języka Transact-SQL).

Uwagi

Komunikat ciąg może być maksymalnie 8000 znaków, długie, jeżeli jest nieobsługujących kodu Unicode ciągi 4 000 znaków długi, jeśli jest to ciągUnicode.Dłuższe ciągi znaków są obcinane.varchar(max) i nvarchar(max) typy danych są obcinane do typów danych, które nie są większe od varchar(8000) i nvarchar(4000).

Informacje, jak aplikacje przetwarzać komunikaty zwracane przez drukowanie instrukcja, zobacz Obsługa błędów i komunikatów w aplikacjach.

RAISERROR może również zwracać komunikaty.RAISERROR ma następujące zalety w porównaniu wydruku:

  • RAISERROR obsługuje argumentów substituting na komunikat o błędzie ciąg przy użyciu mechanizmu modelowana na printf funkcja standardowa biblioteka języka C.

  • RAISERROR można określić numer błędu unikatowy, ważności i kod Państwa, w uzupełnieniu do wiadomości tekstowej.

  • RAISERROR można powrócić przez użytkownika wiadomości utworzone za pomocą sp_addmessage systemu procedura składowana.

Przykłady

A.Warunkowo wykonywanie wydruku (jeśli ISTNIEJE)

W poniższym przykładzie użyto PRINT instrukcja warunkowo zwrócić komunikat.

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.Tworzenie i wyświetlanie ciąg

Poniższy przykład konwertuje wyniki GETDATE funkcja nvarchar Typ danych i łączy go z literały tekstowe mają być zwrócone przez PRINT.

-- Build the message text by concatenating
-- strings and expressions.
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