Udostępnij za pośrednictwem

  • Artykuł

PRINT (Transact-SQL)

Zwraca do klient komunikat zdefiniowanej przez użytkownika.

Topic link iconKonwencje składni języka Transact-SQL

PRINT msg_str | @local_variable | string_expr

Argumenty

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

  • **@local_variable
    To zmienna dowolnego typu danych prawidłowych znaków.    @**local_variable must be char, nchar, varchar, lub nvarchar, lub musi być w stanie są niejawnie konwertowane na tych typów danych.

  • string_expr
    To wyrażenie zwróci ciąg znaków.Może zawierać są połączone wartości literałów, funkcji i zmiennych.Aby uzyskać więcej informacji zobaczExpressions (Transact-SQL).

Remarks

Ciąg komunikatu może być maksymalnie 8000 znaków długości, jeśli jest ciąg nie obsługujących kodu Unicode i 4 000 znaków długości, jeśli jest ciągiem Unicode.Dłuższe ciągi znaków są obcinane.The varchar(max) and nvarchar(max) data types are truncated to data types that are no larger than varchar(8000) and nvarchar(4000).

Aby uzyskać informacje na temat jak aplikacje przetwarza wiadomości, zwracane przez instrukcję PRINT zobacz Obsługa błędów i komunikatów w aplikacji.

RAISERROR można również zwraca wiadomości.RAISERROR ma następujące zalety w porównaniu PRINT:

  • RAISERROR obsługuje substituting argumenty na ciąg komunikatu o błędzie przy użyciu mechanizmu modelowane na funkcja printf standardowa biblioteka języka C.

  • RAISERROR można określić numer unikatowy błędu, wskaźnik ważności i kod stanu oprócz wiadomości tekstowych.

  • RAISERROR może służyć do zwrócenia zdefiniowanych przez użytkownika wiadomości utworzone przy użyciu sp_addmessage systemowa procedura składowana.

Przykłady

A.Warunkowo wykonywanie wydruku (jeżeli EXISTS)

W poniższym przykładzie użyto PRINT Instrukcja warunkowa 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

W poniższym przykładzie konwertuje wyniki GETDATE funkcja nvarchar Wpisz dane i łączy ją ze 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