Assembly : System.Messaging (dans system.messaging.dll)
SyntaxePublic Shared Function Create ( _ path As String _ ) As MessageQueue
Dim path As String Dim returnValue As MessageQueue returnValue = MessageQueue.Create(path)
public static MessageQueue Create ( string path )
public: static MessageQueue^ Create ( String^ path )
public static MessageQueue Create ( String path )
public static function Create ( path : String ) : MessageQueue
Paramètres
- path
Chemin de la file d'attente à créer.
Valeur de retour
MessageQueue représentant la nouvelle file d'attente.
Exceptions| Type d'exception | Condition |
|---|---|
| Le paramètre path est référence Null (Nothing en Visual Basic) ou une chaîne vide (""). | |
| Une file d'attente existe déjà au niveau du chemin spécifié. - ou - Une erreur s'est produite lors de l'accès à une méthode Message Queuing. |
NotesUtilisez cette surcharge pour créer une file d'attente Message Queuing non transactionnelle.
Pour créer une nouvelle instance de la classe MessageQueue dans votre application et la lier à une file d'attente existante, utilisez le constructeur MessageQueue. Pour créer une nouvelle file d'attente dans Message Queuing, appelez la méthode Create(String).
La syntaxe du paramètre path dépend du type de file d'attente à laquelle elle fait référence, comme le montre le tableau suivant.
| Type de file d'attente | Syntaxe |
|---|---|
| File publique | MachineName\QueueName |
| File privée | MachineName\Private$\QueueName |
Utilisez "." pour l'ordinateur local. Pour plus d'informations sur la syntaxe, consultez la propriété Path.
Le tableau suivant montre si cette méthode est disponible dans différents modes groupe de travail.
| Mode groupe de travail | Disponible |
|---|---|
| Ordinateur local | Oui |
| Ordinateur local et nom de format direct | Oui |
| Ordinateur distant | Non |
| Ordinateur distant et nom de format direct | Non |
ExempleL'exemple de code suivant crée des files d'attente publiques et privées. Il envoie un message aux files d'attente sélectionnées.
Imports System Imports System.Messaging ' Provides a container class for the example. Public Class MyNewQueue ' Provides an entry point into the application. ' ' This example creates new public and private ' queues. Public Shared Sub Main() ' Create a new instance of the class. Dim myNewQueue As New MyNewQueue() ' Create public and private queues. myNewQueue.CreatePublicQueues() myNewQueue.CreatePrivateQueues() Return End Sub 'Main ' Creates public queues and sends a message. Public Sub CreatePublicQueues() ' Create and connect to a public Message Queuing queue. If Not MessageQueue.Exists(".\newPublicQueue") Then ' Create the queue if it does not exist. Dim myNewPublicQueue As MessageQueue = _ MessageQueue.Create(".\newPublicQueue") ' Send a message to the queue. myNewPublicQueue.Send("My message data.") End If ' Create (but do not connect to) a second public queue. If Not MessageQueue.Exists(".\newPublicResponseQueue") _ Then MessageQueue.Create(".\newPublicResponseQueue") End If Return End Sub 'CreatePublicQueues ' Creates private queues and sends a message. Public Sub CreatePrivateQueues() ' Create and connect to a private Message Queuing queue. If Not MessageQueue.Exists(".\Private$\newPrivateQueue") _ Then ' Create the queue if it does not exist. Dim myNewPrivateQueue As MessageQueue = _ MessageQueue.Create(".\Private$\newPrivateQueue") ' Send a message to the queue. myNewPrivateQueue.Send("My message data.") End If ' Create (but do not connect to) a second private queue. If Not MessageQueue.Exists(".\Private$\newResponseQueue") _ Then MessageQueue.Create(".\Private$\newResponseQueue") End If Return End Sub 'CreatePrivateQueues End Class 'MyNewQueue
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; } } }
#using <system.dll> #using <system.messaging.dll> using namespace System; using namespace System::Messaging; // This example creates new public and private queues. ref class MyNewQueue { 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. 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; } }; // Provides an entry point into the application. int main() { // Create a new instance of the class. MyNewQueue^ myNewQueue = gcnew MyNewQueue; // Create public and private queues. myNewQueue->CreatePublicQueues(); myNewQueue->CreatePrivateQueues(); return 0; }
package MyProject; import System.*; import System.Messaging.*; /// <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(String[] args) { // Create a new instance of the class. MyNewQueue myNewQueue = new MyNewQueue(); // Create public and private queues. myNewQueue.CreatePublicQueues(); myNewQueue.CreatePrivateQueues(); return; } //main //************************************************** // 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; } //CreatePublicQueues //************************************************** // 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; } //CreatePrivateQueues } //MyNewQueue
Sécurité .NET Framework- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez .
Plates-formesWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ