sys.sp_dropmessage (Transact-SQL)

Şunlar için geçerlidir: SQL Server

SQL Server Database Engine'in bir örneğinden belirli bir kullanıcı tanımlı hata mesajı düşürür. Kullanıcı tanımlı iletiler katalog görünümü kullanılarak sys.messages görüntülenebilir.

Transact-SQL söz dizimi kuralları

Syntax

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

Arguments

[ @msgnum = ] msgnum

Mesaj numarası düşürülecek. @msgnumint, varsayılan olarak .NULL @msgnum , kullanıcı tarafından tanımlanan ve mesaj numarası (50.000) 50000 'den büyük olmalıdır.

[ @lang = ] N'lang'

Mesajın dili düşülecek. @langsysname'dir, varsayılan NULLolarak . Belirtilirse all , @msgnum'ın tüm dil sürümleri bırakılır.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Yok.

Permissions

Sistem yöneticisi üyeliği ve serveradmin sabit sunucu rollerine üyelik gerektirir.

Remarks

@lang için belirtilmedikçeall, mesajın ABD İngilizce versiyonu yayına kaldırılmadan önce tüm yerel versiyonlar kaldırılmalıdır.

Examples

A. Kullanıcı tanımlı bir mesaj bırakın

Aşağıdaki örnek, kullanıcı tanımlı bir mesaj, sayı 50001, .sys.messages

USE master;
GO

EXECUTE sp_dropmessage 50001;

B. Yerel bir versiyon içeren kullanıcı tanımlı bir mesajı bırakın

Aşağıdaki örnek, kullanıcı tanımlı bir mesaj, numara 60000ekliyor ve bu da yerelleştirilmiş bir versiyon içerir, ardından mesajın her iki varyantını da bırakır.

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. Kullanıcı tanımlı bir mesajın yerel versiyonunu bırakın

Aşağıdaki örnek, kullanıcı tarafından tanımlanan bir mesajın yerelleştirilmiş versiyonunu, numarayı 60000, tüm mesajı bırakmadan gönderir.

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

İlgili içerik

  • Last updated on