Bagikan melalui


MessageQueue.MachineName Properti

Definisi

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

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

Atribut

Pengecualian

MachineName adalah null. -atau-

Nama komputer tidak valid, mungkin karena sintaksis salah.

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

Lihat juga