MessageQueueCriteria MessageQueueCriteria MessageQueueCriteria MessageQueueCriteria Class

Definición

Filtra las colas de mensajes cuando se realiza una consulta mediante el método MessageQueue de la clase GetPublicQueues().Filters message queues when performing a query using the MessageQueue class's GetPublicQueues() method.

public ref class MessageQueueCriteria
public class MessageQueueCriteria
type MessageQueueCriteria = class
Public Class MessageQueueCriteria
Herencia
MessageQueueCriteriaMessageQueueCriteriaMessageQueueCriteriaMessageQueueCriteria

Ejemplos

En el ejemplo siguiente se recorre en iteración las colas de mensajes y muestra la ruta de acceso de cada cola que se creó en el último día y que existe en el equipo "MyComputer".The following example iterates through message queues and displays the path of each queue that was created in the last day and that exists on the computer "MyComputer".

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

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

   // Iterates through message queues and displays the
   // path of each queue that was created in the last
   // day and that exists on the computer "MyComputer". 
   void ListPublicQueuesByCriteria()
   {
      UInt32 numberQueues = 0;
      
      // Specify the criteria to filter by.
      MessageQueueCriteria^ myCriteria = gcnew MessageQueueCriteria;
      myCriteria->MachineName = "MyComputer";
      myCriteria->CreatedAfter = DateTime::Now.Subtract( TimeSpan(1,0,0,0) );
      
      // Get a cursor into the queues on the network.
      MessageQueueEnumerator^ myQueueEnumerator = MessageQueue::GetMessageQueueEnumerator( myCriteria );
      
      // 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++;
      }

      
      // Handle no queues matching the criteria.
      if ( numberQueues == 0 )
      {
         Console::WriteLine( "No public queues match criteria." );
      }

      return;
   }

};

int main()
{
   
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;
   
   // Output the count of Lowest priority messages.
   myNewQueue->ListPublicQueuesByCriteria();
   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 uses a cursor to step through the
		// message queues and list the public queues on the
		// network that specify certain criteria.
		//**************************************************

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

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


		//**************************************************
		// Iterates through message queues and displays the
		// path of each queue that was created in the last
		// day and that exists on the computer "MyComputer". 
		//**************************************************
		
		public void ListPublicQueuesByCriteria()
		{
			uint numberQueues = 0;
			
			// Specify the criteria to filter by.
			MessageQueueCriteria myCriteria = new 
				MessageQueueCriteria();
			myCriteria.MachineName = "MyComputer";
			myCriteria.CreatedAfter = DateTime.Now.Subtract(new 
				TimeSpan(1,0,0,0));
	

			// Get a cursor into the queues on the network.
			MessageQueueEnumerator myQueueEnumerator = 
				MessageQueue.GetMessageQueueEnumerator(myCriteria);

			// 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++;
			}

			// Handle no queues matching the criteria.
			if (numberQueues == 0)
			{
				Console.WriteLine("No public queues match criteria.");
			}

			return;
		}
	}
}
Imports System
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 that specify certain criteria.
        

        Public Shared Sub Main()

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

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

            Return

        End Sub 'Main


        
        ' Iterates through message queues and displays the
        ' path of each queue that was created in the last
        ' day and that exists on the computer "MyComputer". 
        

        Public Sub ListPublicQueuesByCriteria()

            Dim numberQueues As Int32 = 0

            ' Specify the criteria to filter by.
            Dim myCriteria As New MessageQueueCriteria()
            myCriteria.MachineName = "MyComputer"
            myCriteria.CreatedAfter = DateTime.Now.Subtract(New _
                TimeSpan(1, 0, 0, 0))


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

            ' 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

            ' Handle no queues matching the criteria.
            If numberQueues = 0 Then
                Console.WriteLine("No queues match the criteria.")
            End If

            Return

        End Sub 'ListPublicQueuesByCriteria

End Class 'MyNewQueue

Comentarios

La MessageQueue clase proporciona varios métodos que permiten filtrar la búsqueda de colas públicas de la red.The MessageQueue class provides a number of methods that enable you to filter your search for public queues on the network. Métodos específicos para filtrar por ubicación de servidor, categoría o etiqueta de cola son los GetPublicQueuesByLabel, GetPublicQueuesByCategory, y GetPublicQueuesByMachine.Specific methods for filtering by queue label, category, or server location are the GetPublicQueuesByLabel, GetPublicQueuesByCategory, and GetPublicQueuesByMachine.

La MessageQueueCriteria de clase, cuando se utiliza con el GetPublicQueues método, permite perfeccionar el filtro.The MessageQueueCriteria class, when used with the GetPublicQueues method, allows you to refine your filter. Puede especificar criterios de búsqueda que no estén controlados por uno de los GetPublicQueuesBy* métodos, o por varios criterios.You can specify search criteria not specifically addressed through one of the GetPublicQueuesBy* methods, or by multiple criteria. Puede pasar un MessageQueueCriteria de instancia en el GetPublicQueues método para buscar, por ejemplo, por tiempos de creación o modificación de la cola, el equipo se encuentra en la cola, la etiqueta de cola, categoría o cualquier combinación de estas propiedades.You can pass a MessageQueueCriteria instance into the GetPublicQueues method in order to search, for example, by queue creation or modification times, the computer the queue resides on, the queue label or category, or any combination of these properties.

Si desea filtrar por varias propiedades, los criterios se crean aplicando la AND operador para el conjunto de propiedades.When filtering by multiple properties, the criteria are composed by applying the AND operator to the set of properties. Por lo tanto, cuando se especifica un valor para la CreatedAfter propiedad junto con la MachineName propiedad, se solicitan todas las colas que fueron creadas después de un tiempo especificado y que residen en un equipo específico.Thus, when you specify a value for the CreatedAfter property together with the MachineName property, you are asking for all queues that were created after a specified time and that reside on a specific computer.

Al establecer cualquier propiedad, el método que establece la propiedad establece también una marca para indicar que deben incluirse en el filtro que está creando.When you set any property, the method that sets the property also sets a flag to indicate that it should be included in the filter you are building. No puede quitar propiedades individuales del filtro de búsqueda.You cannot remove individual properties from the search filter. En su lugar, quite todas las propiedades del filtro llamando a ClearAlly, a continuación, establezca las propiedades que desea incorporar al filtro de búsqueda.Instead, you remove all properties from the filter by calling ClearAll, and then set the properties that you do want to build into the search filter. ClearAll Restablece todas las propiedades al estado predeterminado de "sin establecer".ClearAll resets all properties into a "not set" default state.

Debe establecer una propiedad antes de intentar leerla; de lo contrario, se produce una excepción.You must set a property before trying to read it; otherwise, an exception is thrown.

Constructores

MessageQueueCriteria() MessageQueueCriteria() MessageQueueCriteria() MessageQueueCriteria()

Inicializa una nueva instancia de la clase MessageQueueCriteria.Initializes a new instance of the MessageQueueCriteria class.

Propiedades

Category Category Category Category

Obtiene o establece la categoría por la que se filtran las colas en la red.Gets or sets the category by which to filter queues in the network.

CreatedAfter CreatedAfter CreatedAfter CreatedAfter

Obtiene o establece el límite inferior de la fecha y hora de creación de la cola que se utilizará para filtrar las colas en la red.Gets or sets the lower boundary of the queue creation date and time by which to filter queues on the network.

CreatedBefore CreatedBefore CreatedBefore CreatedBefore

Obtiene o establece el límite superior de la fecha y hora de creación de la cola que se utilizará para filtrar las colas en la red.Gets or sets the upper boundary of the queue creation date and time by which to filter queues on the network.

Label Label Label Label

Obtiene o establece la etiqueta por la que se filtran las colas en la red.Gets or sets the label by which to filter queues in the network.

MachineName MachineName MachineName MachineName

Obtiene o establece el nombre del equipo por el que se filtran las colas en la red.Gets or sets the computer name by which to filter queues in the network.

ModifiedAfter ModifiedAfter ModifiedAfter ModifiedAfter

Obtiene o establece el límite inferior de la fecha y hora de modificación de la cola que se utilizará para filtrar las colas en la red.Gets or sets the lower boundary of the queue modification date and time by which to filter queues on the network.

ModifiedBefore ModifiedBefore ModifiedBefore ModifiedBefore

Obtiene o establece el límite superior de la fecha y hora de modificación de la cola que se utilizará para filtrar las colas en la red.Gets or sets the upper boundary of the queue modification date and time by which to filter queues on the network.

Métodos

ClearAll() ClearAll() ClearAll() ClearAll()

Borra todas las propiedades que se van a integrar en un filtro y asigna el estado de "sin establecer" a todos los valores de propiedad.Clears all properties from being built into a filter and puts all property values into a "not set" state.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: