MessageQueue.MachineName Vlastnost

  • Reference

Definice

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

Získá nebo nastaví název počítače, ve kterém 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 ".", tedy místní počítač.

Atributy
BrowsableAttribute MessagingDescriptionAttribute

Výjimky

ArgumentException

Hodnota 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ě služby Ří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í syntaxe popisného názvu fronty Path. Následující tabulka uvádí syntaxi, kterou byste měli použít pro frontu zadaného typu, když chcete cestu k frontě identifikovat pomocí jejího popisného názvu.

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

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

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

Vlastnosti MachineName, Patha QueueName jsou související. MachineName Změna vlastnosti způsobí Path změnu vlastnosti. Je sestaven z nových MachineName a QueueName. Path Změna (například tak, aby používala syntaxi názvu formátu) obnoví MachineName vlastnosti a QueueName tak, aby odkazy na novou frontu. QueueName Pokud je vlastnost prázdná, Path nastaví se na Deník frontu 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č Yes
Název místního počítače a přímého formátu Yes
Vzdálený počítač Yes
Název vzdáleného počítače a přímého formátu No

Platí pro

Viz také