sys.sp_dropmessage (Transact-SQL)

platí pro:SQL Server

Vypustí specifikovanou uživatelsky definovanou chybovou zprávu z instance Databázový stroj systému SQL Server. Uživatelem definované zprávy lze zobrazit pomocí sys.messages zobrazení katalogu.

Transact-SQL konvence syntaxe

Syntax

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

Arguments

[ @msgnum = ] msgnum

Číslo zprávy k vynechání. @msgnum je int, s výchozím nastavením NULL. @msgnum musí být uživatelem definovaná zpráva, která má číslo zprávy větší než 50000 (50 000).

[ @lang = ] N'lang'

Jazyk zprávy k vypuštění. @lang je sysname, s výchozím nastavením NULL. Pokud all je specifikováno, všechny jazykové verze @msgnum jsou vyřazeny.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Permissions

Vyžaduje členství v rolích správce systému a správce serveru na pevném serveru.

Remarks

all Pokud není pro @lang specifikováno, musí být všechny lokalizované verze zprávy odstraněny, než může být vynechána americká anglická verze zprávy.

Examples

A. Ztraťte uživatelsky definovanou zprávu

Následující příklad vyhazuje uživatelsky definovanou zprávu číslo 50001, z sys.messages.

USE master;
GO

EXECUTE sp_dropmessage 50001;

B. Zrušte uživatelsky definovanou zprávu, která obsahuje lokalizovanou verzi

Následující příklad přidává uživatelem definovanou zprávu číslo 60000, která obsahuje lokalizovanou verzi, a poté obě varianty zprávy opustí.

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. Ztraťte lokalizovanou verzi uživatelem definované zprávy

Následující příklad vyřadí lokalizovanou verzi uživatelem definované zprávy, číslo 60000, aniž by se vynechala celá zpráva.

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

Související obsah

  • Last updated on