MessageQueue.MachineName Proprietà

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Ottiene o imposta il nome del computer in cui si trova la coda di Accodamento messaggi.

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

Valore della proprietà

String

Nome del computer in cui si trova la coda. Il valore predefinito di Accodamento messaggi è "." per indicare il computer locale.

Attributi

BrowsableAttribute MessagingDescriptionAttribute

Eccezioni

ArgumentException

L'elemento MachineName è null. -oppure-

Il nome del computer non è valido, probabilmente perché la sintassi non è corretta.

MessageQueueException

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Esempio

L'esempio di codice seguente ottiene e imposta il valore della proprietà di una coda di MachineName messaggi.

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

Commenti

MachineName è un componente integrale della sintassi del nome descrittivo della coda Path. Nella tabella seguente viene illustrata la sintassi da usare per una coda di un tipo specificato quando si vuole identificare il percorso della coda usando il nome descrittivo.

Tipo di coda	Sintassi
Coda pubblica	MachineName\QueueName
Coda privata	MachineName\Private$\QueueName
Coda del diario	MachineName\QueueName\Journal$
Coda del journal del computer	MachineName\Journal$
Coda dei messaggi non recapitabili del computer	MachineName\Deadletter$
Coda di messaggi non recapitabili transazionali	MachineName\XactDeadletter$

Usare "." per il computer locale quando si specifica .MachineName Solo il nome del computer viene riconosciuto per questa proprietà, ad esempio Server0. La MachineName proprietà non supporta il formato dell'indirizzo IP.

Se si definisce in Path termini di MachineName, l'applicazione genera un'eccezione quando si lavora offline perché il controller di dominio è necessario per la conversione del percorso. Pertanto, è necessario utilizzare per FormatName la Path sintassi quando si lavora offline.

Le MachineNameproprietà , Pathe QueueName sono correlate. La modifica della proprietà comporta la MachineName modifica della Path proprietà. Viene compilato dal nuovo MachineName oggetto e .QueueName Se si Path modifica , ad esempio per usare la sintassi del nome del formato, le MachineName proprietà e QueueName vengono reimpostate in modo che facciano riferimento alla nuova coda. Se la QueueName proprietà è vuota, l'oggetto Path viene impostato sulla coda Journal del computer specificato.

Nella tabella seguente viene illustrato se questa proprietà è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro	Disponibile
Computer locale	Sì
Computer locale e nome del formato diretto	Sì
Computer remoto	Sì
Nome del formato diretto e del computer remoto	No

Vedi anche

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