Partage via


sp_dropmessage (Transact-SQL)

S'applique à : SQL Server

Supprime un message d’erreur défini par l’utilisateur spécifié à partir d’une instance du Moteur de base de données SQL Server. Les messages définis par l’utilisateur peuvent être affichés à l’aide de l’affichage sys.messages catalogue.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @msgnum = ] msgnum

Numéro de message à supprimer. @msgnum est int, avec la valeur par défaut NULL. @msgnum doit être un message défini par l’utilisateur qui est un numéro de message supérieur 50000 à (50 000).

[ @lang = ] N’lang'

Langue du message à supprimer. @lang est sysname, avec la valeur par défaut NULL. Si all elle est spécifiée, toutes les versions linguistiques de @msgnum sont supprimées.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Aucune.

autorisations

Nécessite l’appartenance aux rôles serveur fixe sysadmin et serveradmin .

Notes

Sauf si all elle est spécifiée pour @lang, toutes les versions localisées d’un message doivent être supprimées avant la suppression de la version anglaise américaine du message.

Exemples

R. Supprimer un message défini par l’utilisateur

L’exemple suivant supprime un message défini par l’utilisateur, un nombre 50001, à partir de sys.messages.

USE master;
GO
EXEC sp_dropmessage 50001;

B. Supprimer un message défini par l’utilisateur qui inclut une version localisée

L’exemple suivant ajoute un message défini par l’utilisateur, un numéro 60000, qui inclut une version localisée, puis supprime les deux variantes du message.

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. Supprimer une version localisée d’un message défini par l’utilisateur

L'exemple suivant supprime une version localisée d'un message défini par l'utilisateur (numéro 60000) sans supprimer le message tout entier.

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