MessageQueue.MachineName Vlastnost

Reference

Definice

Obor názvů:: System.Messaging

Sestavení:: System.Messaging.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Sdílet prostřednictvím