sp_dropmessage (Transact-SQL)sp_dropmessage (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Supprime un message d’erreur défini par l’utilisateur à partir d’une instance de la Moteur de base de données SQL ServerSQL Server Database Engine.Drops a specified user-defined error message from an instance of the Moteur de base de données SQL ServerSQL Server Database Engine. Les messages définis par l’utilisateur peuvent être affichés à l’aide de la sys.messages affichage catalogue.User-defined messages can be viewed using the sys.messages catalog view.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


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

ArgumentsArguments

[ @msgnum = ] numéro_de_message[ @msgnum = ] message_number
Numéro du message à supprimer.Is the message number to drop. numéro_de_message doit être un message défini par l’utilisateur qui a un numéro de message supérieur à 50000.message_number must be a user-defined message that has a message number greater than 50000. numéro_de_message est int, avec NULL comme valeur par défaut.message_number is int, with a default of NULL.

[ @lang = ] 'langage'[ @lang = ] 'language'
Langue du message à supprimer.Is the language of the message to drop. Si tous les est spécifié, toutes les versions linguistiques de numéro_de_message sont supprimés.If all is specified, all language versions of message_number are dropped. langage est sysname, avec NULL comme valeur par défaut.language is sysname, with a default of NULL.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

Aucun.None.

PermissionsPermissions

Nécessite l’appartenance dans le sysadmin et serveradmin rôles serveur fixes.Requires membership in the sysadmin and serveradmin fixed server roles.

NotesRemarks

À moins que tous les est spécifiée pour langage, toutes les versions d’un message doivent être supprimées avant de pouvoir supprimer la version en anglais américain du message.Unless all is specified for language, all localized versions of a message must be dropped before the U.S. English version of the message can be dropped.

ExemplesExamples

A.A. Suppression d'un message défini par l'utilisateurDropping a user-defined message

L’exemple suivant supprime un message défini par l’utilisateur, le nombre 50001, à partir de sys.messages.The following example drops a user-defined message, number 50001, from sys.messages.

USE master;  
GO  
EXEC sp_dropmessage 50001;  

B.B. Suppression d'un message défini par l'utilisateur qui comprend une version localiséeDropping a user-defined message that includes a localized version

L'exemple suivant supprime un message défini par l'utilisateur (numéro 60000) qui comprend une version localisée du message.The following example drops a user-defined message, number 60000, that includes a localized version of the 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.C. Suppression d'une version localisée d'un message défini par l'utilisateurDropping a localized version of a user-defined message

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.The following example drops a localized version of a user-defined message, number 60000, without dropping the whole 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 remove only the localized version of the   
-- message.  
EXEC sp_dropmessage  
    @msgnum = 60000,  
    @lang = 'French';  
GO  

Voir aussiSee Also

RAISERROR (Transact-SQL) RAISERROR (Transact-SQL)
sp_addmessage ( Transact-SQL ) sp_addmessage (Transact-SQL)
sp_altermessage ( Transact-SQL ) sp_altermessage (Transact-SQL)
FORMATMESSAGE ( Transact-SQL ) FORMATMESSAGE (Transact-SQL)
sys.messages (Transact-SQL) sys.messages (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)