Bagikan melalui

XmlMessageFormatter.TargetTypeNames Properti

  • Referensi

Definisi

Ruang nama:
System.Messaging
Rakitan:
System.Messaging.dll

Menentukan kumpulan kemungkinan jenis yang akan dideserialisasi oleh pemformat dari pesan yang disediakan.

public:
 property cli::array <System::String ^> ^ TargetTypeNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
[System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")]
public string[] TargetTypeNames { get; set; }
[<System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")>]
member this.TargetTypeNames : string[] with get, set
Public Property TargetTypeNames As String()

Nilai Properti

String[]

Array jenis String yang menentukan jenis objek untuk deserialisasi dari isi pesan saat membaca pesan.

Atribut
MessagingDescriptionAttribute

Pengecualian

ArgumentNullException

Properti TargetTypeNames adalah null.

Keterangan

TargetTypeNames Properti dan TargetTypes memberi tahu pemformat skema apa yang akan dicocokkan saat mendeserialisasi pesan. Ini memungkinkan pemformat untuk menginterpretasikan isi pesan.

Instans yang diserialisasikan dalam isi pesan harus mematuhi salah satu skema yang diwakili dalam array jenis. Saat Anda membaca pesan menggunakan Receive metode , metode membuat objek jenis yang sesuai dengan skema yang diidentifikasi dan membaca isi pesan ke dalamnya.

Hanya salah satu dari dua properti yang perlu diatur saat membaca dari antrean, tetapi Anda dapat mengatur keduanya. Kumpulan jenis adalah kumpulan gabungan dari dua properti. Keputusan properti mana yang akan digunakan khusus untuk aplikasi Anda. Jika isi pesan berisi jenis yang skemanya tidak cocok dengan salah satu jenis dalam array untuk salah satu properti, pengecualian akan dilemparkan saat pesan dibaca.

TargetTypeNames mengharuskan setiap entri sepenuhnya memenuhi syarat, menentukan nama assembly-nya. Selanjutnya, saat bekerja dengan beberapa versi bersamaan, nomor versi juga harus ditambahkan ke nama jenis target juga.

Jenis target hanya diperlukan saat membaca dari antrean. Properti TargetTypeNames dan TargetTypes tidak perlu diatur untuk menulis ke antrean.

Berlaku untuk

Lihat juga