MessageQueue.FormatName Properti

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Mendapatkan nama antrean unik yang dihasilkan Oleh Antrean Pesan pada saat pembuatan antrean.

public:
 property System::String ^ FormatName { System::String ^ get(); };

[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }

[<System.Messaging.MessagingDescription("MQ_FormatName")>]
member this.FormatName : string

Public ReadOnly Property FormatName As String

Nilai Properti

String

Nama untuk antrean, yang unik di jaringan.

Atribut

MessagingDescriptionAttribute

Pengecualian

MessageQueueException

Path belum disetel.

-atau-

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut menampilkan nilai properti antrean FormatName pesan.

// Display the value of the queue's FormatName property.
Console.WriteLine("MessageQueue.FormatName: {0}", queue.FormatName);

Keterangan

Properti FormatName berisi nama format antrean. Antrean Pesan menggunakan nama format untuk mengidentifikasi antrean mana yang akan dibuka dan cara mengaksesnya. Tidak seperti sebagian besar karakteristik antrean, nama format bukan properti antrean aplikasi Antrean Pesan, sehingga Anda tidak dapat mengaksesnya melalui alat manajemen Antrean Pesan. Nama format hanyalah nama unik untuk antrean, yang dihasilkan Oleh Antrean Pesan saat membuat antrean atau yang dihasilkan aplikasi nanti.

Jika Anda menentukan jalur menggunakan sintaks nama jalur (seperti myComputer\myQueue) daripada menggunakan sintaks nama format saat Anda membaca atau menulis ke antrean, pengendali domain utama (yang menggunakan Direktori Aktif) menerjemahkan Path ke dalam yang terkait FormatName sebelum mengakses antrean. Jika aplikasi Anda bekerja offline, Anda harus menggunakan sintaks nama format; jika tidak, pengendali domain utama tidak akan tersedia untuk melakukan terjemahan jalur.

Tabel berikut ini memperlihatkan apakah properti ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja	Tersedia
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Ya
Komputer jarak jauh dan nama format langsung	Ya

Lihat juga

• Path
• Label
• MessageQueue