• Artykuł

sp_dropmessage (Transact-SQL)

Obniży się komunikat o błędzie podany przez użytkownika instancji SQL Server Database Engine. Zdefiniowane przez użytkownika wiadomości można przeglądać za pomocą sys.messages Służy do wyświetlania katalogu.

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

sp_dropmessage [ @msgnum = ] message_number
        [ , [ @lang = ] 'language' ]

Argumenty

  • [ @msgnum = ] message_number
    Is the message number to drop.message_number must be a user-defined message that has a message number greater than 50000.message_number is int, with a default of NULL.

  • [ @lang = ] 'language'
    To język wiadomości mają być umieszczane.If all is specified, all language versions of message_number are dropped.language is sysname, with a default of NULL.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

Brak.

Uprawnienia

Członkostwo w grupie wymaga sysadmin and serveradmin stałe role serwera.

Remarks

Chyba że all jest określony dla language, wszystkich zlokalizowanych wersji wiadomości musi być odrzucone, przed USA Angielską wersja wiadomości mogą być usunięte.

Przykłady

A.Porzucanie wiadomości przez użytkownika

W poniższym przykładzie spadnie wiadomości przez użytkownika, numer 50001, z sys.messages.

USE master;
GO
EXEC sp_dropmessage 50001;

B.Usunięcie użytkownika wiadomość zawierającą zlokalizowanej wersja

W poniższym przykładzie spadnie wiadomości przez użytkownika, numer 60000, zawierającą zlokalizowaną wersja tej wiadomości.

USE master;
GO

-- Create a user-defined message in U.S. English
EXEC sp_addmessage 
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'The item named %s already exists in %s.', 
    @lang = 'us_english';

-- Create a localized version of the same message.
EXEC sp_addmessage 
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'L''élément nommé %1! existe déjà dans %2!',
    @lang = 'French';
GO

-- This statement will fail as long as the localized version
-- of the message exists.
EXEC sp_dropmessage 60000;
GO

-- This statement will drop the message.
EXEC sp_dropmessage
    @msgnum = 60000,
    @lang = 'all';
GO

C.Upuszczanie zlokalizowaną wersja wiadomości przez użytkownika

W poniższym przykładzie spadnie zlokalizowaną wersja wiadomości przez użytkownika, numer 60000, bez usuwania całych wiadomości.

USE master;
GO

-- Create a user-defined message in U.S. English
EXEC sp_addmessage 
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'The item named %s already exists in %s.', 
    @lang = 'us_english';

-- Create a localized version of the same message.
EXEC sp_addmessage 
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'L''élément nommé %1! existe déjà dans %2!',
    @lang = 'French';
GO
-- This statement will remove only the localized version of the 
-- message.
EXEC sp_dropmessage
    @msgnum = 60000,
    @lang = 'French';
GO