MessageQueue.MachineName Properti

Referensi

Definisi

Ruang nama:: System.Messaging

Rakitan:: System.Messaging.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur nama komputer tempat antrean Antrean Pesan berada.

public:
 property System::String ^ MachineName { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_MachineName")>]
member this.MachineName : string with get, set

Public Property MachineName As String

Nilai Properti

String

Nama komputer tempat antrean berada. Default Antrean Pesan adalah ".", komputer lokal.

Atribut: BrowsableAttribute MessagingDescriptionAttribute

Pengecualian

ArgumentException

MachineName adalah null. -atau-

Nama komputer tidak valid, mungkin karena sintaksis salah.

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut mendapatkan dan menetapkan nilai properti antrean MachineName pesan.

// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";

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

Keterangan

MachineName adalah komponen integral dari sintaks nama yang mudah diingat dari antrean Path. Tabel berikut ini memperlihatkan sintaks yang harus Anda gunakan untuk antrean jenis tertentu saat Anda ingin mengidentifikasi jalur antrean menggunakan nama yang mudah diingat.

Jenis antrean	Sintaks
Antrean publik	`MachineName`\`QueueName`
Antrean privat	`MachineName`\`Private$`\`QueueName`
antrean Journal	`MachineName`\`QueueName`\`Journal$`
Antrean jurnal mesin	`MachineName`\`Journal$`
Antrean surat mati mesin	`MachineName`\`Deadletter$`
Antrean surat mati transaksi mesin	`MachineName`\`XactDeadletter$`

Gunakan "." untuk komputer lokal saat menentukan MachineName. Hanya nama komputer yang dikenali untuk properti ini, misalnya, Server0. Properti MachineName tidak mendukung format alamat IP.

Jika Anda menentukan Path dalam hal MachineName, aplikasi melempar pengecualian saat bekerja offline karena pengontrol domain diperlukan untuk terjemahan jalur. Oleh karena itu, Anda harus menggunakan FormatName untuk Path sintaks saat bekerja offline.

Properti MachineName, Path, dan QueueName terkait. Mengubah MachineName properti menyebabkan Path properti berubah. Ini dibangun dari yang baru MachineName dan QueueName. Mengubah Path (misalnya, untuk menggunakan sintaks nama format) mengatur ulang MachineName properti dan QueueName untuk merujuk ke antrean baru. QueueName Jika properti kosong, Path diatur ke antrean Journal komputer yang Anda tentukan.

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	Tidak

Berlaku untuk

Bagikan melalui