PRINT (Transact-SQL)
Gibt eine benutzerdefinierte Meldung an den Client zurück.
Syntax
PRINT msg_str | @local_variable | string_expr
Argumente
msg_str
Eine Zeichen- oder Unicode-Zeichenfolgenkonstante. Weitere Informationen finden Sie unter Konstanten (Transact-SQL).
@local_variable
Dies ist eine Variable eines beliebigen gültigen Zeichendatentyps. @local_variable muss vom Typ char oder varchar sein oder implizit in diese Datentypen konvertiert werden können.
string_expr
Ein Ausdruck, der eine Zeichenfolge zurückgibt. Er kann verkettete Literalwerte, Funktionen und Variablen enthalten. Die Meldungszeichenfolge kann bis zu 8.000 Zeichen enthalten; alle weiteren Zeichen werden abgeschnitten. Weitere Informationen finden Sie unter Ausdrücke (Transact-SQL).
Hinweise
Informationen darüber, wie Anwendungen Meldungen verarbeiten, die von der PRINT-Anweisung zurückgegeben werden, finden Sie unter Behandeln von Fehlern und Meldungen in Anwendungen.
RAISERROR kann auch zum Zurückgeben von Meldungen verwendet werden. RAISERROR hat im Vergleich zu PRINT die folgenden Vorteile:
- RAISERROR unterstützt das Ersetzen von Argumenten in eine Fehlermeldungs-Zeichenfolge. Dabei wird ein Mechanismus verwendet, der auf der printf-Funktion der Standardbibliothek der C-Programmiersprache modelliert wurde.
- RAISERROR kann neben der Textmeldung eine eindeutige Fehlernummer, einen Schweregrad und einen Statuscode angeben.
- Mit RAISERROR lassen sich mithilfe der gespeicherten Systemprozedur sp_addmessage benutzerdefinierte Meldungen zurückgeben.
Beispiele
A. Bedingt ausgeführte PRINT-Anweisung (IF EXISTS)
Dieses Beispiel verwendet die PRINT-Anweisung zur bedingten Rückgabe einer Meldung.
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. Erstellen und Anzeigen einer Zeichenfolge
Dieses Beispiel konvertiert die Ergebnisse der GETDATE-Funktion in einen varchar-Datentyp und verkettet sie mit Literaltext. Das Ergebnis der Verkettung wird von PRINT zurückgegeben.
-- 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
Siehe auch
Verweis
Datentypen (Transact-SQL)
DECLARE @local\_variable (Transact-SQL)
RAISERROR (Transact-SQL)
Andere Ressourcen
Verwenden von PRINT
Verwenden von RAISERROR