Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MessageQueue.Create (String)

 

Data di pubblicazione: ottobre 2016

Crea una coda non transazionale di Accodamento messaggi nel percorso specificato.

Spazio dei nomi:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

public static MessageQueue Create(
	string path
)

Parametri

path
Type: System.String

Il percorso della coda da creare.

Valore restituito

Type: System.Messaging.MessageQueue

Oggetto MessageQueue che rappresenta la nuova coda.

Exception Condition
ArgumentException

Il path parametro null o è una stringa vuota ("").

MessageQueueException

Esiste già una coda nel percorso specificato.

-oppure-

Si è verificato un errore quando si accede a un metodo di Accodamento messaggi.

Utilizzare questo overload per creare una coda di Accodamento messaggi non transazionali.

Per creare una nuova istanza di MessageQueue nell'applicazione e associarla a una coda esistente, utilizzare il MessageQueue costruttore. Per creare una nuova coda in Accodamento messaggi, chiamare Create(String).

La sintassi per la path parametro dipende il tipo di coda a cui fa riferimento, come illustrato nella tabella seguente.

Tipo di coda

Sintassi

Coda pubblica

MachineName\QueueName

Coda privata

MachineName\Private$\QueueName

Utilizzare "." per il computer locale. Per ulteriori informazioni sulla sintassi, vedere la Path proprietà.

Nella tabella seguente indica se questo metodo è disponibile in diverse modalità gruppo di lavoro.

Modalità gruppo di lavoro

Disponibile

Computer locale

Computer locale e il nome di formato direct

Computer remoto

No

Computer remoto e il nome di formato direct

No

Esempio di codice seguente consente di creare code pubbliche e private. Invia un messaggio alle code selezionate.

using System;
using System.Messaging;

namespace MyProject
{
	/// <summary>
	/// Provides a container class for the example.
	/// </summary>
	public class MyNewQueue
	{

		//**************************************************
		// Provides an entry point into the application.
		//		 
		// This example creates new public and private 
		// queues.
		//**************************************************

		public static void Main()
		{
			// Create a new instance of the class.
			MyNewQueue myNewQueue = new MyNewQueue();

			// Create public and private queues.
			myNewQueue.CreatePublicQueues();
			myNewQueue.CreatePrivateQueues();

			return;
		}


		//**************************************************
		// Creates public queues and sends a message.
		//**************************************************

		public void CreatePublicQueues()
		{

			// Create and connect to a public Message Queuing queue.
			if (!MessageQueue.Exists(".\\newPublicQueue"))
			{
				// Create the queue if it does not exist.
				MessageQueue myNewPublicQueue = 
					MessageQueue.Create(".\\newPublicQueue");

				// Send a message to the queue.
				myNewPublicQueue.Send("My message data.");
			}

			// Create (but do not connect to) a second public queue.
			if (!MessageQueue.Exists(".\\newPublicResponseQueue"))
			{
				MessageQueue.Create(".\\newPublicResponseQueue");
			}

			return;

		}


		//**************************************************
		// Creates private queues and sends a message.
		//**************************************************

		public void CreatePrivateQueues()
		{

			// Create and connect to a private Message Queuing queue.
			if (!MessageQueue.Exists(".\\Private$\\newPrivQueue"))
			{
				// Create the queue if it does not exist.
				MessageQueue myNewPrivateQueue = 
					MessageQueue.Create(".\\Private$\\newPrivQueue");

				// Send a message to the queue.
				myNewPrivateQueue.Send("My message data.");
			}

			// Create (but do not connect to) a second private queue.
			if (!MessageQueue.Exists(".\\Private$\\newResponseQueue"))
			{
				MessageQueue.Create(".\\Private$\\newResponseQueue");
			}

			return;
		}
	}
}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: