Udostępnij za pośrednictwem


sp_dropmessage (języka Transact-SQL)

Spada z wystąpienie komunikatu o określonych przez użytkownika Aparat baz danych programu SQL Server.Zdefiniowany przez użytkownika wiadomości można przeglądać za pomocą sys.messages katalogu widoku.

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

Składnia

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

Argumenty

  • [ @ msgnum = ] message_number
    Jest to numer komunikatu , upuść.message_numbermusi być zdefiniowany przez użytkownika wiadomość ma numer komunikatu większa niż 50 000.message_numberjest int, domyślna wartość NULL.

  • [ @lang = ] 'language'
    Jest językiem wiadomości mają być umieszczane.Jeśli all jest określona we wszystkich wersjach językowych message_number są opuszczane.languagejest sysname, domyślna wartość NULL.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

Brak.

Uprawnienia

Wymaga członkostwa w sysadmin i serveradmin stałe role serwera.

Uwagi

Chyba że all określonych dla language, zlokalizowanych wersjach wiadomości być odrzucone, zanim USAMożna upuszczać angielskiej wersja komunikatu.

Przykłady

A.Porzucanie wiadomości zdefiniowane przez użytkownika

Poniższy przykład spadnie wiadomości zdefiniowane przez użytkownika, numer 50001, z sys.messages.

USE master;
GO
EXEC sp_dropmessage 50001;

B.Porzucanie wiadomości zdefiniowane przez użytkownika, zawierający zlokalizowana wersja

Poniższy przykład spadnie wiadomości zdefiniowane przez użytkownika, numer 60000, który zawiera zlokalizowanej wersja 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 zlokalizowana wersja wiadomości zdefiniowane przez użytkownika

Poniższy przykład spadnie zlokalizowana wersja wiadomości zdefiniowane przez użytkownika, numer 60000, bez upuszczanie cały komunikat.

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