MessageQueue.MachineName Właściwość

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Pobiera lub ustawia nazwę komputera, na którym znajduje się kolejka kolejki komunikatów.

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

Wartość właściwości

String

Nazwa komputera, na którym znajduje się kolejka. Wartość domyślna kolejkowania komunikatów to ".", komputer lokalny.

Atrybuty

BrowsableAttribute MessagingDescriptionAttribute

Wyjątki

ArgumentException

Wartość MachineName to null. -lub-

Nazwa komputera jest nieprawidłowa, prawdopodobnie ponieważ składnia jest niepoprawna.

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu pobiera i ustawia wartość właściwości kolejki komunikatów MachineName .

// 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);

Uwagi

Jest MachineName integralnym składnikiem przyjaznej składni nazw kolejki Path. W poniższej tabeli przedstawiono składnię używaną dla kolejki określonego typu, gdy chcesz zidentyfikować ścieżkę kolejki przy użyciu przyjaznej nazwy.

Typ kolejki	Składnia
Kolejka publiczna	MachineName\QueueName
Kolejka prywatna	MachineName\Private$\QueueName
kolejka Dziennik	MachineName\QueueName\Journal$
Kolejka dziennika maszynowego	MachineName\Journal$
Kolejka utraconych komunikatów maszynowych	MachineName\Deadletter$
Kolejka utraconych komunikatów maszyny	MachineName\XactDeadletter$

Użyj "." dla komputera lokalnego podczas określania .MachineName Tylko nazwa komputera jest rozpoznawana dla tej właściwości, na przykład Server0. Właściwość MachineName nie obsługuje formatu adresu IP.

Jeśli zdefiniujesz element Path w kategoriach MachineName, aplikacja zgłasza wyjątek podczas pracy w trybie offline, ponieważ kontroler domeny jest wymagany do tłumaczenia ścieżki. W związku z tym należy użyć elementu FormatName dla Path składni podczas pracy w trybie offline.

Właściwości MachineName, Pathi QueueName są powiązane. MachineName Zmiana właściwości powoduje zmianę Path właściwości. Jest on tworzony na podstawie nowych MachineName i QueueName. Zmiana wartości Path (na przykład w celu użycia składni nazwy formatu) spowoduje zresetowanie MachineName właściwości i QueueName w celu odwoływania się do nowej kolejki. QueueName Jeśli właściwość jest pusta, Path właściwość jest ustawiona na kolejkę Dziennik określonego komputera.

W poniższej tabeli przedstawiono, czy ta właściwość jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej	Dostępne
Komputer lokalny	Tak
Nazwa komputera lokalnego i bezpośredniego formatu	Tak
Komputer zdalny	Tak
Nazwa komputera zdalnego i bezpośredniego formatu	Nie

Zobacz też

• QueueName
• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()