sp_dropmessage (Transact-sql)

Makale
10/29/2012

Belirtilen kullanıcı tanımlı hata iletisi bir örneğinden damla SQL Server Veritabanı Altyapısı. Kullanıcı tanımlı iletileri kullanılarak görüntülenebilir sys.messages Katalog görünümü.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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

Bağımsız değişkenler

**@msgnum =**message_number
Bırakma iletisi sayısıdır. message_number50000'den büyük bir ileti numarası bulunan bir kullanıcı tanımlı ileti olmalıdır. message_numberise int, null varsayılan.
@lang ='language'
Açılan ileti dildir. Eğer allbelirtilen tüm dil sürümlerinde message_numberbırakılır. languageise sysname, null varsayılan.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Sonuç Kümeleri

Yok.

İzinler

Üyelik sysadmin ve serveradmin sunucu rolleri sabit.

Açıklamalar

Sürece alliçin belirtilen language, ABD önce iletinin tüm yerelleştirilmiş sürümleri bırakılan gerekir Mesajın İngilizce sürümü kesilmesini.

Örnekler

A.Kullanıcı tanımlı bir ileti bırakılıyor

Aşağıdaki örnek numarasını bir kullanıcı tanımlı ileti damla 50001, dan sys.messages.

USE master;
GO
EXEC sp_dropmessage 50001;

USE master;
GO
EXEC sp_dropmessage 50001;

B.Yerelleştirilmiş bir sürümünü içeren kullanıcı tanımlı bir ileti bırakılıyor

Aşağıdaki örnek numarasını bir kullanıcı tanımlı ileti damla 60000, bu iletiyi yerelleştirilmiş bir sürümünü içerir.

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

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.Kullanıcı tanımlı bir ileti yerelleştirilmiş sürümü siliniyor

Aşağıdaki örnek numarasını bir kullanıcı tanımlı ileti yerelleştirilmiş sürümü damla 60000, mesaj bırakarak olmadan.

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

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