MessageQueue.MachineName Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property MachineName As StringValore 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 | Sì |
| Computer locale e nome del formato diretto | Sì |
| Computer remoto | Sì |
| Nome del formato diretto e del computer remoto | No |
