formatmessage (Transact-SQL)

Varolan bir iletide iletiden yapıları sys.messages.formatmessage işlevselliğini RAISERROR deyim, benzer.Ancak, ek işlemler biçimli bir iletiye formatmessage verir iken RAISERROR hemen ileti yazdırır.

Konu bağlantısı simgesiTransact-SQL sözdizimi kuralları

Sözdizimi

FORMATMESSAGE ( msg_number , [ param_value [ ,...n ] ] )

Bağımsız değişkenler

  • msg_number
    Depolanan ileti kimliği sys.messages.msg_number Olan <= 13000, ya da ileti, yoksa sys.messages, null döndürülür.

  • param_value
    Bir parametre iletide kullanılacak değeridir.Birden çok parametre değeri olabilir.Yer tutucu değişkenleri iletisinde göründüğü sırada değerleri belirtilmelidir.En fazla değer sayısı 20'dir.

Dönüş Türleri

nvarchar

Açıklamalar

RAISERROR deyimgibi yer tutucu değişkenleri iletisinde sağlanan parametre değerlerini getirilmesiyle formatmessage iletiyi düzenler.Hata iletileri ve düzenleme işlemi izin verilen yer tutucuları hakkında daha fazla bilgi için bkz: RAISERROR (Transact-SQL).

Not

formatmessage yalnızca kullanılarak oluşturulan iletileri ile çalışır e sp_addmessage.

formatmessage geçerli dildeki kullanıcı iletiyi arar.Hiçbir ileti ABD yerelleştirilmiş sürüm iseİngilizce sürüm kullanılır.

Yerelleştirilmiş iletilerin için sağlanan parametre değerleri parametre yer tutucuları ABD karşılık gelmelidirİngilizce sürüm.Diğer bir deyişle, parametresi 1 yerelleştirilmiş sürüm parametre 1 ABD karşılık gelmelidirİngilizce sürüm, parametre 2 gerekir parametre 2 karşılık vb..

Örnekler

Bu örnek, varsayımsal bir ileti depolanan 50001 kullanır sys.messages olarak, "%s içindeki satır sayısını % 1 d'dir." formatmessage tablo1 değerleri ve 5 parametre yer tutucuları ile değiştirir."Tablo1'deki satır sayısından 5 olan" sonuç dize, Yerel değişkende saklanır @var1.

DECLARE @var1 VARCHAR(100)
SELECT @var1 = FORMATMESSAGE(50001, 'Table1', 5)