MessageQueueCriteria Classe

Definizione

Filtra le code dei messaggi durante l'esecuzione di una query, mediante il metodo MessageQueue della classe 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
Ereditarietà
MessageQueueCriteria

Esempi

Nell'esempio seguente viene eseguita l'iterazione delle code di messaggi e viene visualizzato il percorso di ogni coda creata nell'ultimo giorno e esistente nel computer "computer".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.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


        
        ' 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

End Class

Commenti

La MessageQueue classe fornisce una serie di metodi che consentono di filtrare la ricerca di code pubbliche sulla rete.The MessageQueue class provides a number of methods that enable you to filter your search for public queues on the network. Metodi specifici per l'applicazione di filtri in base all'etichetta della coda, alla GetPublicQueuesByLabelcategoria GetPublicQueuesByCategoryo al GetPublicQueuesByMachinepercorso del server sono, e.Specific methods for filtering by queue label, category, or server location are the GetPublicQueuesByLabel, GetPublicQueuesByCategory, and GetPublicQueuesByMachine.

La MessageQueueCriteria classe, se usata con il GetPublicQueues metodo, consente di affinare il filtro.The MessageQueueCriteria class, when used with the GetPublicQueues method, allows you to refine your filter. È possibile specificare criteri di ricerca non indirizzati in modo specifico GetPublicQueuesBytramite uno dei metodi * o in base a più criteri.You can specify search criteria not specifically addressed through one of the GetPublicQueuesBy* methods, or by multiple criteria. È possibile passare un' MessageQueueCriteria istanza GetPublicQueues di al metodo per eseguire la ricerca, ad esempio, in base alle ore di creazione o modifica della coda, al computer in cui si trova la coda, all'etichetta o alla categoria della coda o a qualsiasi combinazione di queste proprietà.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.

Quando si applica il filtro in base a più proprietà, i criteri AND vengono composti applicando l'operatore al set di proprietà.When filtering by multiple properties, the criteria are composed by applying the AND operator to the set of properties. Pertanto, quando si specifica un valore per la CreatedAfter proprietà insieme alla MachineName proprietà, vengono richieste tutte le code create dopo un'ora specificata e che si trovano in un computer specifico.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.

Quando si imposta una proprietà, il metodo che imposta la proprietà imposta anche un flag per indicare che deve essere incluso nel filtro che si sta compilando.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. Non è possibile rimuovere singole proprietà dal filtro di ricerca.You cannot remove individual properties from the search filter. Al contrario, è possibile rimuovere tutte le proprietà dal filtro ClearAllchiamando, quindi impostare le proprietà che si desidera compilare nel filtro di ricerca.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. ClearAllReimposta tutte le proprietà in uno stato predefinito "non impostato".ClearAll resets all properties into a "not set" default state.

È necessario impostare una proprietà prima di provare a leggerla; in caso contrario, viene generata un'eccezione.You must set a property before trying to read it; otherwise, an exception is thrown.

Costruttori

MessageQueueCriteria()

Inizializza una nuova istanza della classe MessageQueueCriteria.Initializes a new instance of the MessageQueueCriteria class.

Proprietà

Category

Ottiene o imposta la categoria in base alla quale filtrare le code nella rete.Gets or sets the category by which to filter queues in the network.

CreatedAfter

Ottiene o imposta il limite inferiore della data e dell'ora di creazione della coda in base al quale filtrare le code sulla rete.Gets or sets the lower boundary of the queue creation date and time by which to filter queues on the network.

CreatedBefore

Ottiene o imposta il limite superiore della data e dell'ora di creazione della coda in base al quale filtrare le code sulla rete.Gets or sets the upper boundary of the queue creation date and time by which to filter queues on the network.

Label

Ottiene o imposta l'etichetta in base alla quale filtrare le code nella rete.Gets or sets the label by which to filter queues in the network.

MachineName

Ottiene o imposta il nome del computer in base al quale filtrare le code nella rete.Gets or sets the computer name by which to filter queues in the network.

ModifiedAfter

Ottiene o imposta il limite inferiore della data e dell'ora di modifica della coda in base al quale filtrare le code sulla rete.Gets or sets the lower boundary of the queue modification date and time by which to filter queues on the network.

ModifiedBefore

Ottiene o imposta il limite superiore della data e dell'ora di modifica della coda in base al quale filtrare le code sulla rete.Gets or sets the upper boundary of the queue modification date and time by which to filter queues on the network.

Metodi

ClearAll()

Cancella tutte le proprietà in modo che non vengano incorporate nel filtro e imposta tutti i valori delle proprietà sullo stato "non impostato".Clears all properties from being built into a filter and puts all property values into a "not set" state.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche