sys.sp_dropmessage (Transact-SQL)

Gäller för:SQL Server

Släpper ett specificerat användardefinierat felmeddelande från en instans av Databasmotor för SQL Server. Användardefinierade meddelanden kan visas med hjälp av sys.messages katalogvyn.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_dropmessage
    [ [ @msgnum = ] msgnum ]
    [ , [ @lang = ] N'lang' ]
[ ; ]

Arguments

[ @msgnum = ] msgnum

Meddelandenumret som ska lämnas. @msgnum är int, med standardvärdet .NULL @msgnum måste vara ett användardefinierat meddelande med ett meddelandenummer större än 50000 (50 000).

[ @lang = ] N'lang'

Språket i meddelandet som ska släppas. @lang är sysname, med standardvärdet .NULL Om all anges tas alla språkversioner av @msgnum bort.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

None.

Permissions

Kräver medlemskap i sysadmin- och serveradmin-fixserverrollerna .

Remarks

Om all inte specificeras för @lang måste alla lokaliserade versioner av ett meddelande släppas innan den amerikanska engelska versionen av meddelandet kan tas bort.

Examples

A. Släpp ett användardefinierat meddelande

Följande exempel tar bort ett användardefinierat meddelande, nummer 50001, från sys.messages.

USE master;
GO

EXECUTE sp_dropmessage 50001;

B. Släpp ett användardefinierat meddelande som inkluderar en lokaliserad version

Följande exempel lägger till ett användardefinierat meddelande, nummer 60000, som inkluderar en lokaliserad version, och sedan tar bort båda varianterna av meddelandet.

USE master;
GO

-- Create a user-defined message in U.S. English
EXECUTE 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.
EXECUTE 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.
EXECUTE sp_dropmessage 60000;
GO

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

C. Släpp en lokaliserad version av ett användardefinierat meddelande

Följande exempel släpper en lokaliserad version av ett användardefinierat meddelande, nummer 60000, utan att ta bort hela meddelandet.

USE master;
GO

-- Create a user-defined message in U.S. English
EXECUTE 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.
EXECUTE 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.
EXECUTE sp_dropmessage
    @msgnum = 60000,
    @lang = 'French';
GO

Relaterat innehåll

  • Last updated on