Share via


MessageQueue Konstruktor

Definisi

Menginisialisasi instans baru kelas MessageQueue.

Overload

MessageQueue()

Menginisialisasi instans baru kelas MessageQueue. Setelah konstruktor tanpa parameter menginisialisasi instans baru, Anda harus mengatur properti instans Path sebelum Dapat menggunakan instans.

MessageQueue(String)

Menginisialisasi instans MessageQueue baru kelas yang mereferensikan antrean Antrean Pesan di jalur yang ditentukan.

MessageQueue(String, Boolean)

Menginisialisasi instans MessageQueue baru kelas yang mereferensikan antrean Antrean Pesan di jalur yang ditentukan dan dengan pembatasan akses baca yang ditentukan.

MessageQueue(String, QueueAccessMode)

Menginisialisasi instans baru kelas MessageQueue.

MessageQueue(String, Boolean, Boolean)

Menginisialisasi instans baru kelas MessageQueue.

MessageQueue(String, Boolean, Boolean, QueueAccessMode)

Menginisialisasi instans baru kelas MessageQueue.

MessageQueue()

Menginisialisasi instans baru kelas MessageQueue. Setelah konstruktor tanpa parameter menginisialisasi instans baru, Anda harus mengatur properti instans Path sebelum Dapat menggunakan instans.

public:
 MessageQueue();
public MessageQueue ();
Public Sub New ()

Contoh

Contoh kode berikut membuat baru 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";

Keterangan

Gunakan kelebihan beban ini untuk membuat instans MessageQueue baru kelas yang tidak segera terikat dengan antrean di server Antrean Pesan. Sebelum menggunakan instans ini, Anda harus menyambungkannya ke antrean Antrean Pesan yang ada dengan mengatur Path properti . Atau, Anda dapat mengatur MessageQueue referensi ke Create(String) nilai pengembalian metode, sehingga membuat antrean Antrean Pesan baru.

Konstruktor MessageQueue membuat instans MessageQueue baru kelas; konstruktor tidak membuat antrean Antrean Pesan baru.

Tabel berikut ini memperlihatkan nilai properti awal untuk instans MessageQueue.

Properti Nilai awal
DefaultPropertiesToSend Nilai yang ditetapkan oleh konstruktor tanpa parameter kelas DefaultPropertiesToSend .
Formatter XmlMessageFormatter
MessageReadPropertyFilter Nilai yang ditetapkan oleh konstruktor tanpa parameter kelas MessagePropertyFilter . Semua nilai filter diatur ke true.
DenySharedReceive false

Lihat juga

Berlaku untuk

MessageQueue(String)

Menginisialisasi instans MessageQueue baru kelas yang mereferensikan antrean Antrean Pesan di jalur yang ditentukan.

public:
 MessageQueue(System::String ^ path);
public MessageQueue (string path);
new System.Messaging.MessageQueue : string -> System.Messaging.MessageQueue
Public Sub New (path As String)

Parameter

path
String

Lokasi antrean yang direferensikan oleh ini MessageQueue.

Pengecualian

Properti Path tidak valid, mungkin karena belum disetel.

Contoh

Contoh kode berikut membuat objek baru MessageQueue menggunakan berbagai jenis sintaks nama jalur. Dalam setiap kasus, ia mengirim pesan ke antrean yang jalurnya ditentukan dalam konstruktor.

#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

Keterangan

Gunakan kelebihan beban ini saat Anda ingin mengikat instans baru MessageQueue ke antrean Antrean Pesan tertentu, yang jalurnya Anda ketahui, nama format, atau labelnya. Jika Anda ingin memberikan akses eksklusif ke aplikasi pertama yang mereferensikan antrean, Anda harus mengatur DenySharedReceive properti ke true atau menggunakan konstruktor yang melewati parameter pembatasan akses baca.

Konstruktor MessageQueue membuat instans MessageQueue baru kelas; konstruktor tidak membuat antrean Antrean Pesan baru. Untuk membuat antrean baru di Antrean Pesan, gunakan Create(String).

Sintaks parameter path tergantung pada jenis antrean yang direferensikannya, seperti yang ditunjukkan dalam tabel berikut.

Jenis antrean Sintaks
Antrean publik MachineName\QueueName
Antrean privat MachineName\Private$\QueueName
antrean Journal MachineName\QueueName\Journal$
Antrean jurnal mesin MachineName\Journal$
Antrean surat mati mesin MachineName\Deadletter$
Antrean surat mati transaksi mesin MachineName\XactDeadletter$

Atau, Anda dapat menggunakan FormatName atau Label untuk menjelaskan jalur antrean, seperti yang diperlihatkan dalam tabel berikut.

Referensi Sintaks Contoh
Nama format FormatName: [ nama format ] FormatName:Public= 5A5F7535-AE9A-41d4-935C-845C2AFF7112

FormatName:DIRECT=SPX:NetworkNumber; HostNumber\QueueName

FormatName:DIRECT=TCP: IPAddress\QueueName

FormatName:DIRECT=OS: MachineName\QueueName
Label Label: [ label ] Label: TheLabel

Untuk bekerja offline, Anda harus menggunakan sintaks nama format, bukan sintaks nama jalur untuk konstruktor. Jika tidak, pengecualian dilemparkan karena pengontrol domain utama tidak tersedia untuk menyelesaikan jalur ke nama format.

Tabel berikut ini memperlihatkan nilai properti awal untuk instans MessageQueue. Nilai-nilai ini didasarkan pada properti antrean Antrean Pesan dengan jalur yang ditentukan oleh path parameter .

Properti Nilai awal
Authenticate false
BasePriority 0
Category Empty
DefaultPropertiesToSend Nilai yang ditetapkan oleh konstruktor tanpa parameter kelas DefaultPropertiesToSend .
EncryptionRequired true, jika pengaturan tingkat privasi antrean Antrean Pesan adalah "Isi"; jika tidak, false.
Formatter XmlMessageFormatter
Label Empty
MachineName Nilai properti nama komputer antrean Antrean Pesan.
MaximumJournalSize InfiniteQueueSize
MaximumQueueSize InfiniteQueueSize
MessageReadPropertyFilter Nilai yang ditetapkan oleh konstruktor tanpa parameter kelas MessagePropertyFilter .
Path Empty, jika tidak diatur oleh konstruktor.
QueueName Empty, jika tidak diatur oleh konstruktor.
DenySharedReceive false
UseJournalQueue true, jika pengaturan jurnal objek Antrean Pesan diaktifkan; jika tidak, false.

Lihat juga

Berlaku untuk

MessageQueue(String, Boolean)

Menginisialisasi instans MessageQueue baru kelas yang mereferensikan antrean Antrean Pesan di jalur yang ditentukan dan dengan pembatasan akses baca yang ditentukan.

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)

Parameter

path
String

Lokasi antrean yang direferensikan oleh ini MessageQueue, yang dapat berupa "." untuk komputer lokal.

sharedModeDenyReceive
Boolean

true untuk memberikan akses baca eksklusif ke aplikasi pertama yang mengakses antrean; jika tidak, false.

Pengecualian

Properti Path tidak valid, mungkin karena belum disetel.

Contoh

Contoh kode berikut membuat baru MessageQueue dengan akses eksklusif, mengatur jalurnya, dan mengirim pesan ke antrean.

#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

Keterangan

Gunakan kelebihan beban ini saat Anda ingin mengikat yang baru MessageQueue ke antrean Antrean Pesan tertentu, yang jalurnya Anda ketahui, nama format, atau labelnya. Jika Anda ingin memberikan akses eksklusif ke aplikasi pertama yang mereferensikan antrean, atur parameter ke sharedModeDenyReceivetrue. Jika tidak, atur sharedModeDenyReceive ke false atau gunakan konstruktor yang hanya memiliki path parameter.

Pengaturan sharedModeDenyReceive ke true memengaruhi semua objek yang mengakses antrean Antrean Pesan, termasuk aplikasi lain. Efek parameter tidak dibatasi untuk aplikasi ini.

MessageQueue Konstruktor membuat instans MessageQueue baru kelas; konstruktor tidak membuat antrean Antrean Pesan baru. Untuk membuat antrean baru di Antrean Pesan, gunakan Create(String).

Sintaks parameter path tergantung pada jenis antrean.

Jenis antrean Sintaks
Antrean publik MachineName\QueueName
Antrean privat MachineName\Private$\QueueName
antrean Journal MachineName\QueueName\Journal$
Antrean jurnal mesin MachineName\Journal$
Antrean surat mati mesin MachineName\Deadletter$
Antrean surat mati transaksi mesin MachineName\XactDeadletter$

Atau, Anda dapat menggunakan nama format atau label antrean Antrean Pesan untuk menjelaskan jalur antrean.

Referensi Sintaks Contoh
Nama format FormatName: [ nama format ] FormatName:Public= 5A5F7535-AE9A-41d4-935C-845C2AFF7112

FormatName:DIRECT=SPX:NetworkNumber; HostNumber\QueueName

FormatName:DIRECT=TCP: IPAddress\QueueName

FormatName:DIRECT=OS: MachineName\QueueName
Label Label: [ label ] Label: TheLabel

Untuk bekerja offline, Anda harus menggunakan sintaks nama format, bukan sintaks nama yang mudah diingat. Jika tidak, pengecualian dilemparkan karena pengendali domain utama (tempat Direktori Aktif berada) tidak tersedia untuk menyelesaikan jalur ke nama format.

MessageQueue Jika membuka antrean dengan parameter yang sharedModeDenyReceive diatur ke true, setiap MessageQueue yang kemudian mencoba membaca dari antrean menghasilkan MessageQueueException karena pelanggaran berbagi. MessageQueueException juga dilemparkan jika mencoba mengakses antrean dalam mode eksklusif sementara yang MessageQueue lain MessageQueue sudah memiliki akses non-eksklusif ke antrean.

Tabel berikut ini memperlihatkan nilai properti awal untuk instans MessageQueue. Nilai-nilai ini didasarkan pada properti antrean Antrean Pesan, dengan jalur yang ditentukan oleh path parameter .

Properti Nilai awal
Authenticate false.
BasePriority 0.
Category Empty.
DefaultPropertiesToSend Nilai yang ditetapkan oleh konstruktor tanpa parameter kelas DefaultPropertiesToSend .
EncryptionRequired true, jika pengaturan tingkat privasi antrean Antrean Pesan adalah "Isi"; jika tidak, false.
Formatter XmlMessageFormatter.
Label Empty.
MachineName Nilai properti nama komputer antrean Antrean Pesan.
MaximumJournalSize InfiniteQueueSize.
MaximumQueueSize InfiniteQueueSize.
MessageReadPropertyFilter Nilai yang ditetapkan oleh konstruktor tanpa parameter kelas MessagePropertyFilter .
Path Empty, jika tidak ditetapkan oleh konstruktor.
QueueName Empty, jika tidak ditetapkan oleh konstruktor.
DenySharedReceive Nilai sharedModeDenyReceive parameter .
UseJournalQueue true, jika pengaturan jurnal objek Antrean Pesan diaktifkan; jika tidak, false.

Lihat juga

Berlaku untuk

MessageQueue(String, QueueAccessMode)

Menginisialisasi instans baru kelas 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)

Parameter

path
String

Lokasi antrean yang direferensikan oleh ini MessageQueue, yang dapat berupa "." untuk komputer lokal.

accessMode
QueueAccessMode

Salah QueueAccessMode satu nilai.

Berlaku untuk

MessageQueue(String, Boolean, Boolean)

Menginisialisasi instans baru kelas 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)

Parameter

path
String

Lokasi antrean yang direferensikan oleh ini MessageQueue, yang dapat berupa "." untuk komputer lokal.

sharedModeDenyReceive
Boolean

true untuk memberikan akses baca eksklusif ke aplikasi pertama yang mengakses antrean; jika tidak, false.

enableCache
Boolean

true untuk membuat dan menggunakan cache koneksi; jika tidak, false.

Contoh

Contoh kode berikut membuat yang baru MessageQueue dengan akses baca eksklusif dan dengan penembolokan koneksi diaktifkan.

// 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);

Berlaku untuk

MessageQueue(String, Boolean, Boolean, QueueAccessMode)

Menginisialisasi instans baru kelas 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)

Parameter

path
String

Lokasi antrean yang direferensikan oleh ini MessageQueue, yang dapat berupa "." untuk komputer lokal.

sharedModeDenyReceive
Boolean

true untuk memberikan akses baca eksklusif ke aplikasi pertama yang mengakses antrean; jika tidak, false.

enableCache
Boolean

true untuk membuat dan menggunakan cache koneksi; jika tidak, false.

accessMode
QueueAccessMode

Salah QueueAccessMode satu nilai.

Berlaku untuk