formatmessage (Transact-sql)
Varolan iletisinde iletiyi oluşturur sys.messages. formatmessage işlevselliğini RAISERROR deyimi benzer. Ancak, diğer işlemler biçimli bir iletiye formatmessage verir ise RAISERROR hemen ileti yazdırır.
.gif "Konu bağlantısı simgesi")
Transact-SQL Sözdizim Kuralları
Sözdizimi
FORMATMESSAGE ( msg_number , [ param_value [ ,...n ] ] )
Bağımsız değişkenler
msg_number
Depolanan ileti kimliği sys.messages. Eğer msg_numberolduğunu <= 13000, ya da ileti içinde yoksa sys.messages, null döndürülür.param_value
Parametre değeri ileti kullanımda olduğunu. Birden çok parametre değeri olabilir. Yer tutucu değişkenleri ileti içinde göründükleri sırada değerleri belirtilmelidir. Değerleri sayısı 20'dir.
Dönüş Türleri
nvarchar
Açıklamalar
RAISERROR deyimi gibi formatmessage yerine yer tutucu değişkenleri iletisinde sağlanan parametre değerlerini kullanarak iletiyi düzenler. Hata iletileri ve düzenleme işlemi izin yer tutucuları hakkında daha fazla bilgi için bkz: RAISERROR (Transact-SQL).
[!NOT]
formatmessage yalnızca kullanılarak oluşturulan iletilerle inşaat sp_addmessage.
formatmessage kullanıcının geçerli dil mesaj arar. İleti, ABD hiçbir yerelleştirilmiş sürümü ise İngilizce sürümü kullanılır.
Yerelleştirilmiş iletilerin sağlanan parametre değerleri parametre yer tutucuları ABD'de eşleşmelidir İngilizce versiyonu. Başka bir deyişle, parametresi 1 yerelleştirilmiş sürümü parametresi 1 ABD karşılık gelmelidir İngilizce, parametre 2 gerekir parametre 2 karşılık vb..
Örnekler
Aşağıdaki örnek, varsayımsal bir ileti kullanır 50001depolanan sys.messagesolarak, "%s içindeki satır sayısını % 1 ö. ise" formatmessage değerlerini değiştirir Table1ve 5parametresi yer tutucular için. Sonuç dizesi "Tablo1 satır sayısı 5'tir", yerel değişken depolanan @var1.
DECLARE @var1 VARCHAR(100)
SELECT @var1 = FORMATMESSAGE(50001, 'Table1', 5)
DECLARE @var1 VARCHAR(100)
SELECT @var1 = FORMATMESSAGE(50001, 'Table1', 5)