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 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 è ".", il computer locale.
- Attributi
Eccezioni
Il 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 journal | MachineName\QueueName\Journal$ |
| Coda del journal del computer | MachineName\Journal$ |
| Coda messaggi non recapitabili del computer | MachineName\Deadletter$ |
| Coda di messaggi non recapitabili transazionali del computer | MachineName\XactDeadletter$ |
Usare "." per il computer locale quando si specifica .MachineName Solo il nome del computer viene riconosciuto per questa proprietà, Server0ad esempio . 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 usare FormatName per la Path sintassi quando si lavora offline.
Le MachineNameproprietà , Pathe QueueName sono correlate. La modifica della proprietà determina la MachineName modifica della Path proprietà. Viene compilato dal nuovo MachineName oggetto e da QueueName. La modifica di Path (ad esempio, per usare la sintassi del nome di formato) reimposta le MachineName proprietà e QueueName per fare riferimento alla nuova coda. Se la QueueName proprietà è vuota, Path viene impostata 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ì |
| Computer remoto e nome del formato diretto | No |
