MessageQueue Constructeurs

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Initialise une nouvelle instance de la classe MessageQueue.

Surcharges

MessageQueue()	Initialise une nouvelle instance de la classe MessageQueue. Une fois la nouvelle instance initialisée par le constructeur sans paramètre, vous devez définir sa propriété Path avant de pouvoir l’utiliser.
MessageQueue(String)	Initialise une nouvelle instance de la classe MessageQueue qui fait référence à la file d'attente Message Queuing dans le chemin d'accès spécifié.
MessageQueue(String, Boolean)	Initialise une nouvelle instance de la classe MessageQueue qui fait référence à la file d'attente Message Queuing dans le chemin d'accès et avec la restriction d'accès en lecture spécifiés.
MessageQueue(String, QueueAccessMode)	Initialise une nouvelle instance de la classe MessageQueue.
MessageQueue(String, Boolean, Boolean)	Initialise une nouvelle instance de la classe MessageQueue.
MessageQueue(String, Boolean, Boolean, QueueAccessMode)	Initialise une nouvelle instance de la classe MessageQueue.

MessageQueue()

Initialise une nouvelle instance de la classe MessageQueue. Une fois la nouvelle instance initialisée par le constructeur sans paramètre, vous devez définir sa propriété Path avant de pouvoir l’utiliser.

public:
 MessageQueue();

public MessageQueue ();

Public Sub New ()

Exemples

L’exemple de code suivant crée un nouveau MessageQueue.

// Connect to a queue on the local computer. You must set the queue's
// Path property before you can use the queue.
MessageQueue queue = new MessageQueue();
queue.Path = ".\\exampleQueue";

Remarques

Utilisez cette surcharge pour créer une nouvelle instance de la MessageQueue classe qui n’est pas immédiatement liée à une file d’attente sur le serveur Message Queuing. Avant d’utiliser cette instance, vous devez la connecter à une file d’attente Message Queuing existante en définissant la Path propriété . Vous pouvez également définir la référence à la MessageQueue valeur de retour de la Create(String) méthode, créant ainsi une file d’attente Message Queuing.

Le MessageQueue constructeur instancie une nouvelle instance de la MessageQueue classe ; il ne crée pas de file d’attente Message Queuing.

Le tableau suivant montre les valeurs de propriété initiales d’un instance de MessageQueue.

Propriété	Valeur initiale
DefaultPropertiesToSend	Valeurs définies par le constructeur sans paramètre de la DefaultPropertiesToSend classe .
Formatter	XmlMessageFormatter
MessageReadPropertyFilter	Valeurs définies par le constructeur sans paramètre de la MessagePropertyFilter classe . Toutes les valeurs de filtre sont définies sur true.
DenySharedReceive	false

Voir aussi

• Path
• QueueName
• FormatName
• Label

MessageQueue(String)

Initialise une nouvelle instance de la classe MessageQueue qui fait référence à la file d'attente Message Queuing dans le chemin d'accès spécifié.

public:
 MessageQueue(System::String ^ path);

public MessageQueue (string path);

new System.Messaging.MessageQueue : string -> System.Messaging.MessageQueue

Public Sub New (path As String)

Paramètres

path

String

Emplacement de la file d'attente référencée par ce MessageQueue.

Exceptions

ArgumentException

La propriété Path n'est pas valide ; elle n'a probablement pas été définie.

Exemples

L’exemple de code suivant crée des MessageQueue objets à l’aide de différents types de syntaxe de nom de chemin d’accès. Dans chaque cas, il envoie un message à la file d’attente dont le chemin est défini dans le constructeur.

#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;
ref class MyNewQueue
{
public:

   // References public queues.
   void SendPublic()
   {
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
      myQueue->Send( "Public queue by path name." );
      return;
   }


   // References private queues.
   void SendPrivate()
   {
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\Private$\\myQueue" );
      myQueue->Send( "Private queue by path name." );
      return;
   }


   // References queues by label.
   void SendByLabel()
   {
      MessageQueue^ myQueue = gcnew MessageQueue( "Label:TheLabel" );
      myQueue->Send( "Queue by label." );
      return;
   }


   // References queues by format name.
   void SendByFormatName()
   {
      MessageQueue^ myQueue = gcnew MessageQueue( "FormatName:Public=5A5F7535-AE9A-41d4 -935C-845C2AFF7112" );
      myQueue->Send( "Queue by format name." );
      return;
   }


   // References computer journal queues.
   void MonitorComputerJournal()
   {
      MessageQueue^ computerJournal = gcnew MessageQueue( ".\\Journal$" );
      while ( true )
      {
         Message^ journalMessage = computerJournal->Receive();
         
         // Process the journal message.
      }
   }


   // References queue journal queues.
   void MonitorQueueJournal()
   {
      MessageQueue^ queueJournal = gcnew MessageQueue( ".\\myQueue\\Journal$" );
      while ( true )
      {
         Message^ journalMessage = queueJournal->Receive();
         
         // Process the journal message.
      }
   }


   // References dead-letter queues.
   void MonitorDeadLetter()
   {
      MessageQueue^ deadLetter = gcnew MessageQueue( ".\\DeadLetter$" );
      while ( true )
      {
         Message^ deadMessage = deadLetter->Receive();
         
         // Process the dead-letter message.
      }
   }


   // References transactional dead-letter queues.
   void MonitorTransactionalDeadLetter()
   {
      MessageQueue^ TxDeadLetter = gcnew MessageQueue( ".\\XactDeadLetter$" );
      while ( true )
      {
         Message^ txDeadLetter = TxDeadLetter->Receive();
         
         // Process the transactional dead-letter message.
      }
   }

};


//*************************************************
// Provides an entry point into the application.
//         
// This example demonstrates several ways to set
// a queue's path.
//*************************************************
int main()
{
   
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;
   myNewQueue->SendPublic();
   myNewQueue->SendPrivate();
   myNewQueue->SendByLabel();
   myNewQueue->SendByFormatName();
   myNewQueue->MonitorComputerJournal();
   myNewQueue->MonitorQueueJournal();
   myNewQueue->MonitorDeadLetter();
   myNewQueue->MonitorTransactionalDeadLetter();
   return 0;
}

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 demonstrates several ways to set
        // a queue's path.
        //**************************************************

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

            myNewQueue.SendPublic();
            myNewQueue.SendPrivate();
            myNewQueue.SendByLabel();
            myNewQueue.SendByFormatName();
            myNewQueue.MonitorComputerJournal();
            myNewQueue.MonitorQueueJournal();
            myNewQueue.MonitorDeadLetter();
            myNewQueue.MonitorTransactionalDeadLetter();

            return;
        }
        
        // References public queues.
        public void SendPublic()
        {
            MessageQueue myQueue = new MessageQueue(".\\myQueue");
            myQueue.Send("Public queue by path name.");

            return;
        }

        // References private queues.
        public void SendPrivate()
        {
            MessageQueue myQueue = new
                MessageQueue(".\\Private$\\myQueue");
            myQueue.Send("Private queue by path name.");

            return;
        }

        // References queues by label.
        public void SendByLabel()
        {
            MessageQueue myQueue = new MessageQueue("Label:TheLabel");
            myQueue.Send("Queue by label.");

            return;
        }

        // References queues by format name.
        public void SendByFormatName()
        {
            MessageQueue myQueue = new
                MessageQueue("FormatName:Public=5A5F7535-AE9A-41d4" +
                "-935C-845C2AFF7112");
            myQueue.Send("Queue by format name.");

            return;
        }

        // References computer journal queues.
        public void MonitorComputerJournal()
        {
            MessageQueue computerJournal = new
                MessageQueue(".\\Journal$");
            while(true)
            {
                Message journalMessage = computerJournal.Receive();
                // Process the journal message.
            }
        }

        // References queue journal queues.
        public void MonitorQueueJournal()
        {
            MessageQueue queueJournal = new
                MessageQueue(".\\myQueue\\Journal$");
            while(true)
            {
                Message journalMessage = queueJournal.Receive();
                // Process the journal message.
            }
        }
        
        // References dead-letter queues.
        public void MonitorDeadLetter()
        {
            MessageQueue deadLetter = new
                MessageQueue(".\\DeadLetter$");
            while(true)
            {
                Message deadMessage = deadLetter.Receive();
                // Process the dead-letter message.
            }
        }

        // References transactional dead-letter queues.
        public void MonitorTransactionalDeadLetter()
        {
            MessageQueue TxDeadLetter = new
                MessageQueue(".\\XactDeadLetter$");
            while(true)
            {
                Message txDeadLetter = TxDeadLetter.Receive();
                // Process the transactional dead-letter message.
            }
        }
    }
}

Imports System.Messaging

Public Class MyNewQueue


        
        ' Provides an entry point into the application.
        '		 
        ' This example demonstrates several ways to set
        ' a queue's path.
        

        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue()

            myNewQueue.SendPublic()
            myNewQueue.SendPrivate()
            myNewQueue.SendByLabel()
            myNewQueue.SendByFormatName()
            myNewQueue.MonitorComputerJournal()
            myNewQueue.MonitorQueueJournal()
            myNewQueue.MonitorDeadLetter()
            myNewQueue.MonitorTransactionalDeadLetter()

            Return

        End Sub


        ' References public queues.
        Public Sub SendPublic()

            Dim myQueue As New MessageQueue(".\myQueue")
            myQueue.Send("Public queue by path name.")

            Return

        End Sub


        ' References private queues.
        Public Sub SendPrivate()

            Dim myQueue As New MessageQueue(".\Private$\myQueue")
            myQueue.Send("Private queue by path name.")

            Return

        End Sub


        ' References queues by label.
        Public Sub SendByLabel()

            Dim myQueue As New MessageQueue("Label:TheLabel")
            myQueue.Send("Queue by label.")

            Return

        End Sub


        ' References queues by format name.
        Public Sub SendByFormatName()

            Dim myQueue As New _
                MessageQueue("FormatName:Public=" + _
                    "5A5F7535-AE9A-41d4-935C-845C2AFF7112")
            myQueue.Send("Queue by format name.")

            Return

        End Sub


        ' References computer journal queues.
        Public Sub MonitorComputerJournal()

            Dim computerJournal As New MessageQueue(".\Journal$")

            While True

                Dim journalMessage As Message = _
                    computerJournal.Receive()

                ' Process the journal message.

            End While

            Return
        End Sub


        ' References queue journal queues.
        Public Sub MonitorQueueJournal()

            Dim queueJournal As New _
                            MessageQueue(".\myQueue\Journal$")

            While True

                Dim journalMessage As Message = _
                    queueJournal.Receive()

                ' Process the journal message.

            End While

            Return
        End Sub


        ' References dead-letter queues.
        Public Sub MonitorDeadLetter()
            Dim deadLetter As New MessageQueue(".\DeadLetter$")

            While True

                Dim deadMessage As Message = deadLetter.Receive()

                ' Process the dead-letter message.

            End While

            Return

        End Sub


        ' References transactional dead-letter queues.
        Public Sub MonitorTransactionalDeadLetter()

            Dim TxDeadLetter As New MessageQueue(".\XactDeadLetter$")

            While True

                Dim txDeadLetterMessage As Message = _
                    TxDeadLetter.Receive()

                ' Process the transactional dead-letter message.

            End While

            Return

        End Sub

End Class

Remarques

Utilisez cette surcharge lorsque vous souhaitez lier la nouvelle MessageQueue instance à une file d’attente Message Queuing particulière, dont vous connaissez le chemin, le nom de format ou l’étiquette. Si vous souhaitez accorder un accès exclusif à la première application qui fait référence à la file d’attente, vous devez définir la DenySharedReceive propriété sur true ou utiliser le constructeur qui transmet un paramètre de restriction d’accès en lecture.

Le MessageQueue constructeur instancie une nouvelle instance de la MessageQueue classe ; il ne crée pas de file d’attente Message Queuing. Pour créer une file d’attente dans Message Queuing, utilisez Create(String).

La syntaxe du paramètre dépend du path type de file d’attente qu’il référence, comme indiqué dans le tableau suivant.

Type de file d'attente	Syntaxe
File d'attente publique	MachineName\QueueName
File d'attente privée	MachineName\Private$\QueueName
File d'attente du journal	MachineName\QueueName\Journal$
File d’attente du journal de l’ordinateur	MachineName\Journal$
File d’attente de lettres mortes de l’ordinateur	MachineName\Deadletter$
File d’attente de lettres mortes transactionnelles de l’ordinateur	MachineName\XactDeadletter$

Vous pouvez également utiliser ou FormatNameLabel pour décrire le chemin d’accès de la file d’attente, comme indiqué dans le tableau suivant.

Informations de référence	Syntaxe	Exemple
Nom de format	FormatName: [ format name ]	FormatName:Public= 5A5F7535-AE9A-41d4-935C-845C2AFF7112 FormatName:DIRECT=SPX:NetworkNumber; HostNumber\QueueName FormatName:DIRECT=TCP: IPAddress\QueueName FormatName:DIRECT=OS: MachineName\QueueName
Etiquette	Label: [ label ]	Label: TheLabel

Pour travailler hors connexion, vous devez utiliser la syntaxe de nom de format, et non la syntaxe de nom de chemin d’accès pour le constructeur. Sinon, une exception est levée, car le contrôleur de domaine principal n’est pas disponible pour résoudre le chemin d’accès au nom de format.

Le tableau suivant montre les valeurs de propriété initiales d’un instance de MessageQueue. Ces valeurs sont basées sur les propriétés de la file d’attente Message Queuing avec le chemin spécifié par le path paramètre .

Property	Valeur initiale
Authenticate	false
BasePriority	0
Category	Empty
DefaultPropertiesToSend	Valeurs définies par le constructeur sans paramètre de la DefaultPropertiesToSend classe .
EncryptionRequired	true, si le paramètre de niveau de confidentialité de la file d’attente Message Queuing est « Corps » ; sinon, false.
Formatter	XmlMessageFormatter
Label	Empty
MachineName	Valeur de la propriété nom d’ordinateur de la file d’attente Message Queuing.
MaximumJournalSize	InfiniteQueueSize
MaximumQueueSize	InfiniteQueueSize
MessageReadPropertyFilter	Valeurs définies par le constructeur sans paramètre de la MessagePropertyFilter classe .
Path	Empty, s’il n’est pas défini par le constructeur.
QueueName	Empty, s’il n’est pas défini par le constructeur.
DenySharedReceive	false
UseJournalQueue	true, si le paramètre de journal de l’objet Message Queuing est activé ; sinon, false.

Voir aussi

• FormatName
• Label
• QueueName
• Path

MessageQueue(String, Boolean)

Initialise une nouvelle instance de la classe MessageQueue qui fait référence à la file d'attente Message Queuing dans le chemin d'accès et avec la restriction d'accès en lecture spécifiés.

public:
 MessageQueue(System::String ^ path, bool sharedModeDenyReceive);

public MessageQueue (string path, bool sharedModeDenyReceive);

new System.Messaging.MessageQueue : string * bool -> System.Messaging.MessageQueue

Public Sub New (path As String, sharedModeDenyReceive As Boolean)

Paramètres

path

String

Emplacement de la file d'attente référencée par ce MessageQueue. Cela peut correspondre à "." pour l'ordinateur local.

sharedModeDenyReceive

Boolean

true pour accorder un accès en lecture exclusif à la première application qui accède à la file d'attente ; sinon, false.

Exceptions

ArgumentException

La propriété Path n'est pas valide ; elle n'a probablement pas été définie.

Exemples

L’exemple de code suivant crée un nouveau MessageQueue avec un accès exclusif, définit son chemin d’accès et envoie un message à la file d’attente.

#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;
ref class MyNewQueue
{
public:

   // Requests exlusive read access to the queue. If
   // access is granted, receives a message from the 
   // queue.
   void GetExclusiveAccess()
   {
      try
      {
         
         // Request exclusive read access to the queue.
         MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue",true );
         
         // Receive a message. This is where SharingViolation 
         // exceptions would be thrown.
         Message^ myMessage = myQueue->Receive();
      }
      catch ( MessageQueueException^ e ) 
      {
         
         // Handle request for denial of exclusive read access.
         if ( e->MessageQueueErrorCode == MessageQueueErrorCode::SharingViolation )
         {
            Console::WriteLine( "Denied exclusive read access" );
         }

         
         // Handle other sources of a MessageQueueException.
      }

      
      // Handle other exceptions as necessary.
      return;
   }

};


// Provides an entry point into the application.
// This example connects to a message queue, and
// requests exclusive read access to the queue.
int main()
{
   
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;
   
   // Output the count of Lowest priority messages.
   myNewQueue->GetExclusiveAccess();
   return 0;
}

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 connects to a message queue, and
        // requests exclusive read access to the queue.
        //**************************************************

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

            // Output the count of Lowest priority messages.
            GetExclusiveAccess();
                        
            return;
        }

        //**************************************************
        // Requests exlusive read access to the queue. If
        // access is granted, receives a message from the
        // queue.
        //**************************************************
        
        public static void GetExclusiveAccess()
        {
            try
            {
                // Request exclusive read access to the queue.
                MessageQueue myQueue = new
                    MessageQueue(".\\myQueue", true);

                // Receive a message. This is where SharingViolation
                // exceptions would be thrown.
                Message myMessage = myQueue.Receive();
            }
            
            catch (MessageQueueException e)
            {
                // Handle request for denial of exclusive read access.
                if (e.MessageQueueErrorCode ==
                    MessageQueueErrorCode.SharingViolation)
                {
                    Console.WriteLine("Denied exclusive read access");
                }

                // Handle other sources of a MessageQueueException.
            }

            // Handle other exceptions as necessary.

            return;
        }
    }
}

Imports System.Messaging

Public Class MyNewQueue


        ' Provides an entry point into the application.
        '		 
        ' This example connects to a message queue, and
        ' requests exclusive read access to the queue.
 

        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue()

            ' Output the count of Lowest priority messages.
            myNewQueue.GetExclusiveAccess()

            Return

        End Sub


  
        ' Requests exlusive read access to the queue. If
        ' access is granted, receives a message from the 
        ' queue.
  

        Public Sub GetExclusiveAccess()

            Try

                ' Request exclusive read access to the queue.
                Dim myQueue As New MessageQueue(".\myQueue", True)

                ' Receive a message. This is where a SharingViolation 
                ' exception would be thrown.
                Dim myMessage As Message = myQueue.Receive()

            Catch e As MessageQueueException

                ' Handle request for denial of exclusive read access.
                If e.MessageQueueErrorCode = _
                    MessageQueueErrorCode.SharingViolation Then

                    Console.WriteLine("Denied exclusive read access.")

                End If

                ' Handle other sources of a MessageQueueException.

                ' Handle other exceptions as necessary.

            End Try

            Return

        End Sub

End Class

Remarques

Utilisez cette surcharge lorsque vous souhaitez lier le nouveau MessageQueue à une file d’attente Message Queuing particulière, dont vous connaissez le chemin, le nom de format ou l’étiquette. Si vous souhaitez accorder un accès exclusif à la première application qui fait référence à la file d’attente, définissez le paramètre sur sharedModeDenyReceivetrue. Sinon, définissez sharedModeDenyReceivefalse sur ou utilisez le constructeur qui n’a qu’un path paramètre.

La définition de sharedModeDenyReceive sur affecte tous les objets qui accèdent à true la file d’attente Message Queuing, y compris d’autres applications. Les effets du paramètre ne sont pas limités à cette application.

Le MessageQueue constructeur crée une nouvelle instance de la MessageQueue classe ; il ne crée pas de file d’attente Message Queuing. Pour créer une file d’attente dans Message Queuing, utilisez Create(String).

La syntaxe du paramètre dépend du path type de file d’attente.

Type de file d'attente	Syntaxe
File d'attente publique	MachineName\QueueName
File d'attente privée	MachineName\Private$\QueueName
File d'attente du journal	MachineName\QueueName\Journal$
File d’attente du journal de l’ordinateur	MachineName\Journal$
File d’attente de lettres mortes de l’ordinateur	MachineName\Deadletter$
File d’attente de lettres mortes transactionnelles de l’ordinateur	MachineName\XactDeadletter$

Vous pouvez également utiliser le nom de format ou l’étiquette d’une file d’attente Message Queuing pour décrire le chemin de la file d’attente.

Informations de référence	Syntaxe	Exemple
Nom de format	FormatName: [ format name ]	FormatName:Public= 5A5F7535-AE9A-41d4-935C-845C2AFF7112 FormatName:DIRECT=SPX:NetworkNumber; HostNumber\QueueName FormatName:DIRECT=TCP: IPAddress\QueueName FormatName:DIRECT=OS: MachineName\QueueName
Etiquette	Label: [ label ]	Label: TheLabel

Pour travailler hors connexion, vous devez utiliser la syntaxe de nom de format plutôt que la syntaxe de nom convivial. Sinon, une exception est levée, car le contrôleur de domaine principal (sur lequel réside Active Directory) n’est pas disponible pour résoudre le chemin d’accès au nom de format.

Si un MessageQueue ouvre une file d’attente avec le sharedModeDenyReceive paramètre défini sur true, celui MessageQueue qui tente par la suite de lire à partir de la file d’attente génère un MessageQueueException en raison d’une violation de partage. Un MessageQueueException est également levée si un tente d’accéder MessageQueue à la file d’attente en mode exclusif alors qu’un autre MessageQueue a déjà un accès non exclusif à la file d’attente.

Le tableau suivant montre les valeurs de propriété initiales d’un instance de MessageQueue. Ces valeurs sont basées sur les propriétés de la file d’attente Message Queuing, avec le chemin spécifié par le path paramètre.

Property	Valeur initiale
Authenticate	false.
BasePriority	0.
Category	Empty.
DefaultPropertiesToSend	Valeurs définies par le constructeur sans paramètre de la DefaultPropertiesToSend classe.
EncryptionRequired	true, si le paramètre de niveau de confidentialité de la file d’attente Message Queuing est « Corps » ; sinon, false.
Formatter	XmlMessageFormatter.
Label	Empty.
MachineName	Valeur de la propriété nom de l’ordinateur de la file d’attente Message Queuing.
MaximumJournalSize	InfiniteQueueSize.
MaximumQueueSize	InfiniteQueueSize.
MessageReadPropertyFilter	Valeurs définies par le constructeur sans paramètre de la MessagePropertyFilter classe.
Path	Empty, s’il n’est pas défini par le constructeur.
QueueName	Empty, s’il n’est pas défini par le constructeur.
DenySharedReceive	Valeur du paramètre sharedModeDenyReceive.
UseJournalQueue	true, si le paramètre journal de l’objet Message Queuing est activé ; sinon, false.

Voir aussi

• FormatName
• Label
• Path
• QueueName
• DenySharedReceive

MessageQueue(String, QueueAccessMode)

Initialise une nouvelle instance de la classe MessageQueue.

public:
 MessageQueue(System::String ^ path, System::Messaging::QueueAccessMode accessMode);

public MessageQueue (string path, System.Messaging.QueueAccessMode accessMode);

new System.Messaging.MessageQueue : string * System.Messaging.QueueAccessMode -> System.Messaging.MessageQueue

Public Sub New (path As String, accessMode As QueueAccessMode)

Paramètres

path

String

Emplacement de la file d'attente référencée par ce MessageQueue. Cela peut correspondre à "." pour l'ordinateur local.

accessMode

QueueAccessMode

Une des valeurs de l'objet QueueAccessMode.

MessageQueue(String, Boolean, Boolean)

Initialise une nouvelle instance de la classe MessageQueue.

public:
 MessageQueue(System::String ^ path, bool sharedModeDenyReceive, bool enableCache);

public MessageQueue (string path, bool sharedModeDenyReceive, bool enableCache);

new System.Messaging.MessageQueue : string * bool * bool -> System.Messaging.MessageQueue

Public Sub New (path As String, sharedModeDenyReceive As Boolean, enableCache As Boolean)

Paramètres

path

String

Emplacement de la file d'attente référencée par ce MessageQueue. Cela peut correspondre à "." pour l'ordinateur local.

sharedModeDenyReceive

Boolean

true pour accorder un accès en lecture exclusif à la première application qui accède à la file d'attente ; sinon, false.

enableCache

Boolean

true pour créer et utiliser un cache de connexions, sinon false.

Exemples

L’exemple de code suivant crée un nouveau MessageQueue avec un accès en lecture exclusif et avec la mise en cache de connexion activée.

// Connect to a queue on the local computer, grant exclusive read
// access to the first application that accesses the queue, and
// enable connection caching.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue", true, true);

queue->Close();

// Connect to a queue on the local computer, grant exclusive read
// access to the first application that accesses the queue, and
// enable connection caching.
MessageQueue queue = new MessageQueue(".\\exampleQueue", true, true);

MessageQueue(String, Boolean, Boolean, QueueAccessMode)

Initialise une nouvelle instance de la classe MessageQueue.

public:
 MessageQueue(System::String ^ path, bool sharedModeDenyReceive, bool enableCache, System::Messaging::QueueAccessMode accessMode);

public MessageQueue (string path, bool sharedModeDenyReceive, bool enableCache, System.Messaging.QueueAccessMode accessMode);

new System.Messaging.MessageQueue : string * bool * bool * System.Messaging.QueueAccessMode -> System.Messaging.MessageQueue

Public Sub New (path As String, sharedModeDenyReceive As Boolean, enableCache As Boolean, accessMode As QueueAccessMode)

Paramètres

path

String

Emplacement de la file d'attente référencée par ce MessageQueue. Cela peut correspondre à "." pour l'ordinateur local.

sharedModeDenyReceive

Boolean

true pour accorder un accès en lecture exclusif à la première application qui accède à la file d'attente ; sinon, false.

enableCache

Boolean

true pour créer et utiliser un cache de connexions, sinon false.

accessMode

QueueAccessMode

Une des valeurs de l'objet QueueAccessMode.