MessageQueue.GetPublicQueuesByCategory(Guid) Metoda

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Pobiera wszystkie kolejki publiczne w sieci, które należą do określonej kategorii.

public static System.Messaging.MessageQueue[] GetPublicQueuesByCategory (Guid category);

Parametry

category

Guid

Element Guid , który grupuje zestaw kolejek do pobrania.

Zwraca

MessageQueue[]

Tablica MessageQueue obiektów odwołujących się do pobranych kolejek publicznych.

Wyjątki

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu pobiera listy kolejek.

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 gets lists of queues by a variety
        // of criteria.
        //**************************************************

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

            // Send normal and high priority messages.
            myNewQueue.GetQueuesByCategory();
            myNewQueue.GetQueuesByLabel();
            myNewQueue.GetQueuesByComputer();
            myNewQueue.GetAllPublicQueues();
            myNewQueue.GetPublicQueuesByCriteria();
            myNewQueue.GetPrivateQueues();
                        
            return;
        }

        //**************************************************
        // Gets a list of queues with a specified category.
        // Sends a broadcast message to all queues in that
        // category.
        //**************************************************
        
        public void GetQueuesByCategory()
        {
            // Get a list of queues with the specified category.
            MessageQueue[] QueueList =
                MessageQueue.GetPublicQueuesByCategory(new
                Guid("{00000000-0000-0000-0000-000000000001}"));

            // Send a broadcast message to each queue in the array.
            foreach(MessageQueue queueItem in QueueList)
            {
                queueItem.Send("Broadcast message.");
            }
            
            return;
        }

        //**************************************************
        // Gets a list of queues with a specified label.
        // Sends a broadcast message to all queues with that
        // label.
        //**************************************************
        
        public void GetQueuesByLabel()
        {
            // Get a list of queues with the specified label.
            MessageQueue[] QueueList =
                MessageQueue.GetPublicQueuesByLabel("My Label");

            // Send a broadcast message to each queue in the array.
            foreach(MessageQueue queueItem in QueueList)
            {
                queueItem.Send("Broadcast message.");
            }
            
            return;
        }

        //**************************************************
        // Gets a list of queues on a specified computer.
        // Displays the list on screen.
        //**************************************************
        
        public void GetQueuesByComputer()
        {
            // Get a list of queues on the specified computer.
            MessageQueue[] QueueList =
                MessageQueue.GetPublicQueuesByMachine("MyComputer");

            // Display the paths of the queues in the list.
            foreach(MessageQueue queueItem in QueueList)
            {
                Console.WriteLine(queueItem.Path);
            }

            return;
        }

        //**************************************************
        // Gets a list of all public queues.
        //**************************************************
        
        public void GetAllPublicQueues()
        {
            // Get a list of public queues.
            MessageQueue[] QueueList =
                MessageQueue.GetPublicQueues();
    
            return;
        }

        //**************************************************
        // Gets a list of all public queues that match
        // specified criteria. Displays the list on
        // screen.
        //**************************************************
        
        public void GetPublicQueuesByCriteria()
        {
            // Define criteria to filter the queues.
            MessageQueueCriteria myCriteria = new
                MessageQueueCriteria();
            myCriteria.CreatedAfter = DateTime.Now.Subtract(new
                TimeSpan(1,0,0,0));
            myCriteria.ModifiedBefore = DateTime.Now;
            myCriteria.MachineName = ".";
            myCriteria.Label = "My Queue";
            
            // Get a list of queues with that criteria.
            MessageQueue[] QueueList =
                MessageQueue.GetPublicQueues(myCriteria);

            // Display the paths of the queues in the list.
            foreach(MessageQueue queueItem in QueueList)
            {
                Console.WriteLine(queueItem.Path);
            }

            return;
        }

        //**************************************************
        // Gets a list of private queues on the local
        // computer. Displays the list on screen.
        //**************************************************
        
        public void GetPrivateQueues()
        {
            // Get a list of queues with the specified category.
            MessageQueue[] QueueList =
                MessageQueue.GetPrivateQueuesByMachine(".");

            // Display the paths of the queues in the list.
            foreach(MessageQueue queueItem in QueueList)
            {
                Console.WriteLine(queueItem.Path);
            }
            
            return;
        }
    }
}

Uwagi

Ta metoda służy do filtrowania kolejek publicznych według kategorii. Właściwość Category zapewnia dostęp do właściwości identyfikatora typu kolejkowania komunikatów (która jest odczytem/zapisem) określonej kolejki. Chociaż można użyć NewGuid polecenia , aby utworzyć wartość kategorii, która jest unikatowa dla wszystkich Guid wartości, nie jest to konieczne. Wartość kategorii musi być różna tylko od innych kategorii, a nie ze wszystkich innych Guid wartości. Można na przykład przypisać {00000000-0000-0000-0000-000000000001} jako element Category dla jednego zestawu kolejek i {00000000-0000-0000-0000-000000000002} jako Category dla innego zestawu.

GetPublicQueuesByCategory(Guid) pobiera statyczną migawkę kolejek. Aby wchodzić w interakcję z dynamiczną listą kolejek, użyj polecenia GetMessageQueueEnumerator. Możesz określić kategorię w ramach przekazywanej MessageQueueCriteria metody .

W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej	Dostępne
Komputer lokalny	Nie
Nazwa komputera lokalnego i bezpośredniego formatu	Nie
Komputer zdalny	Nie
Nazwa komputera zdalnego i bezpośredniego formatu	Nie

Dotyczy

Zobacz też

• Category
• GetPublicQueues()
• GetMessageQueueEnumerator()