MessageQueueEnumerator Clase

Referencia

Definición

Espacio de nombres:: System.Messaging

Ensamblado:: System.Messaging.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Ofrece un cursor de solo avance para enumerar los mensajes de una cola de mensajes.

public ref class MessageQueueEnumerator : MarshalByRefObject, IDisposable, System::Collections::IEnumerator

public class MessageQueueEnumerator : MarshalByRefObject, IDisposable, System.Collections.IEnumerator

type MessageQueueEnumerator = class
    inherit MarshalByRefObject
    interface IEnumerator
    interface IDisposable

Public Class MessageQueueEnumerator
Inherits MarshalByRefObject
Implements IDisposable, IEnumerator

Herencia: Object

MarshalByRefObject
MessageQueueEnumerator

Implementaciones: IEnumerator IDisposable

Ejemplos

El siguiente ejemplo de código recorre en iteración todas las colas de mensajes de la red y examina la ruta de acceso de cada cola. Por último, muestra el número de colas públicas en la red.

#using <System.dll>
#using <System.Messaging.dll>

using namespace System;
using namespace System::Messaging;

//**************************************************
// Iterates through message queues and examines the
// path for each queue. Also displays the number of
// public queues on the network.
//**************************************************
void ListPublicQueues()
{
   
   // Holds the count of private queues.
   int numberQueues = 0;
   
   // Get a cursor into the queues on the network.
   MessageQueueEnumerator^ myQueueEnumerator = MessageQueue::GetMessageQueueEnumerator();
   
   // Move to the next queue and read its path.
   while ( myQueueEnumerator->MoveNext() )
   {
      
      // Increase the count if priority is Lowest.
      Console::WriteLine( myQueueEnumerator->Current->Path );
      numberQueues++;
   }

   
   // Display final count.
   Console::WriteLine( "Number of public queues: {0}", numberQueues );
   return;
}


//**************************************************
// Provides an entry point into the application.
//   
// This example uses a cursor to step through the
// message queues and list the public queues on the
// network.
//**************************************************
int main()
{
   
   // Output the count of Lowest priority messages.
   ListPublicQueues();
}

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 uses a cursor to step through the
        // message queues and list the public queues on the
        // network.
        //**************************************************

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

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

        //**************************************************
        // Iterates through message queues and examines the
        // path for each queue. Also displays the number of
        // public queues on the network.
        //**************************************************
        
        public void ListPublicQueues()
        {
            // Holds the count of private queues.
            uint numberQueues = 0;
    
            // Get a cursor into the queues on the network.
            MessageQueueEnumerator myQueueEnumerator =
                MessageQueue.GetMessageQueueEnumerator();

            // Move to the next queue and read its path.
            while(myQueueEnumerator.MoveNext())
            {
                // Increase the count if priority is Lowest.
                Console.WriteLine(myQueueEnumerator.Current.Path);
                numberQueues++;
            }

            // Display final count.
            Console.WriteLine("Number of public queues: " +
                numberQueues.ToString());
            
            return;
        }
    }
}

Imports System.Messaging



Public Class MyNewQueue


        
        ' Provides an entry point into the application.
        '		 
        ' This example uses a cursor to step through the
        ' message queues and list the public queues on the
        ' network.
        

        Public Shared Sub Main()

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

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

            Return

        End Sub


        
        ' Iterates through message queues and examines the
        ' path for each queue. Also displays the number of
        ' public queues on the network.
        

        Public Sub ListPublicQueues()

            ' Holds the count of private queues.
            Dim numberQueues As Int32 = 0

            ' Get a cursor into the queues on the network.
            Dim myQueueEnumerator As MessageQueueEnumerator = _
                MessageQueue.GetMessageQueueEnumerator()

            ' Move to the next queue and read its path.
            While myQueueEnumerator.MoveNext()
                ' Increase the count if the priority is Lowest.
                Console.WriteLine(myQueueEnumerator.Current.Path)
                numberQueues += 1
            End While

            ' Display final count.
            Console.WriteLine(("Number of public queues: " + _
                numberQueues.ToString()))

            Return

        End Sub

End Class

Comentarios

Se usa MessageQueueEnumerator para la interacción dinámica con colas en la red. Los métodos disponibles a través de la MessageQueue clase pueden devolver un MessageQueueEnumerator objeto que contiene una lista dinámica de colas o una matriz que contiene una instantánea de la colección de colas en el momento en que se llamó al método especificado.

No hay ninguna ordenación definida de las colas en una red. No se ordenan, por ejemplo, por equipo, etiqueta, estado público o privado, u otros criterios accesibles para el usuario. Un MessageQueueEnumerator es un cursor, inicializado en el encabezado de una lista dinámica. Puede mover el cursor a la primera cola de la enumeración llamando a MoveNext. Una vez inicializado el enumerador, puede usar MoveNext para avanzar paso a paso por las colas restantes.

No es posible retroceder con .MessageQueueEnumerator Un cursor solo permite el movimiento hacia delante a través de la enumeración de cola. Sin embargo, puede llamar Reset a para restablecer la enumeración y volver a colocar el cursor al principio de la lista. Dado que el enumerador es dinámico, el enumerador puede tener acceso a una cola anexada más allá de la posición actual del cursor. Una cola que se inserta antes de que no se pueda acceder a la posición actual del cursor sin llamar primero a Reset.

Propiedades

Current	Obtiene el objeto MessageQueue actual de la enumeración.
LocatorHandle	Obtiene el identificador nativo de Message Queuing que se utiliza para buscar colas en una red.

Métodos

Close()	Libera los recursos asociados al enumerador.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa MessageQueueEnumerator.
Dispose(Boolean)	Libera los recursos no administrados que usa MessageQueueEnumerator y, de forma opcional, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Finalize()	Libera los recursos mantenidos por la cola.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
MoveNext()	Desplaza el enumerador a la siguiente cola de la enumeración si hay alguna disponible.
Reset()	Restablece el cursor, de forma que señala al principio de la enumeración.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IEnumerator.Current

Obtiene el objeto MessageQueue actual de la enumeración.

Se aplica a

Compartir vía