Condividi tramite


MessageQueue.MachineName Proprietà

Definizione

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à

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

Attributi

Eccezioni

L'elemento MachineName è null. -oppure-

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

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
Computer locale e nome del formato diretto
Computer remoto
Nome del formato diretto e del computer remoto No

Si applica a

Vedi anche