Udostępnij za pośrednictwem

MessageQueue.MachineName Właściwość

  • Odwołanie

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

Dotyczy

Zobacz też