Sdílet prostřednictvím

MessageQueue.MachineName Vlastnost

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

Získá nebo nastaví název počítače, kde je umístěna fronta služby Řízení front zpráv.

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

Hodnota vlastnosti

String

Název počítače, ve kterém se nachází fronta. Výchozí nastavení služby Řízení front zpráv je ".", místní počítač.

Atributy
BrowsableAttribute MessagingDescriptionAttribute

Výjimky

ArgumentException

To MachineName je null. nebo

Název počítače není platný, pravděpodobně proto, že syntaxe je nesprávná.

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu získá a nastaví hodnotu vlastnosti fronty MachineName zpráv.

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

Poznámky

Je MachineName nedílnou součástí popisné syntaxe názvu fronty Path. Následující tabulka uvádí syntaxi, kterou byste měli použít pro frontu zadaného typu, pokud chcete identifikovat cestu k frontě pomocí popisného názvu.

Typ fronty Syntaxe
Veřejná fronta MachineName\QueueName
Soukromá fronta MachineName\Private$\QueueName
Fronta deníku MachineName\QueueName\Journal$
Fronta deníku počítačů MachineName\Journal$
Fronta nedoručených zpráv počítače MachineName\Deadletter$
Fronta nedoručených zpráv počítače MachineName\XactDeadletter$

Pro místní počítač použijte při zadávání .MachineName Pro tuto vlastnost je rozpoznán pouze název počítače, Server0například . Vlastnost MachineName nepodporuje formát IP adresy.

Pokud definujete Path podmínky MachineName, aplikace vyvolá výjimku při práci offline, protože řadič domény je vyžadován pro překlad cesty. Proto je nutné použít syntaxi FormatName pro Path práci offline.

Objekty MachineName, Patha QueueName vlastnosti jsou související. MachineName Změna vlastnosti způsobí, že se Path vlastnost změní. Je postaven z nového MachineName a QueueName. Path Změna syntaxe názvu formátu (například pro použití syntaxe názvu formátu) obnoví MachineName vlastnosti a QueueName odkazuje na novou frontu. QueueName Pokud je vlastnost prázdná, Path je nastavena na frontu Deníku počítače, který zadáte.

Následující tabulka ukazuje, zda je tato vlastnost k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny K dispozici
Místní počítač Ano
Název místního počítače a přímého formátu Ano
Vzdálený počítač Ano
Název vzdáleného počítače a přímého formátu Ne

Platí pro

Viz také