MessageQueueCriteria MessageQueueCriteria MessageQueueCriteria MessageQueueCriteria Class

Definition

Filtert Meldungswarteschlangen beim Durchführen einer Abfrage mit der MessageQueue-Methode der GetPublicQueues()-Klasse.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
Vererbung
MessageQueueCriteriaMessageQueueCriteriaMessageQueueCriteriaMessageQueueCriteria

Beispiele

Im folgenden Beispiel werden die Nachrichten Warteschlangen durchlaufen und der Pfad jeder Warteschlange angezeigt, die am letzten Tag erstellt wurde und auf dem Computer "MyComputer" vorhanden ist.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

Hinweise

Die MessageQueue -Klasse stellt eine Reihe von Methoden bereit, die es Ihnen ermöglichen, die Suche nach öffentlichen Warteschlangen im Netzwerk zu filtern.The MessageQueue class provides a number of methods that enable you to filter your search for public queues on the network. Bestimmte Methoden zum Filtern nach der Warteschlangen Bezeichnung, der Kategorie oder dem GetPublicQueuesByLabelServer Speicherort sind, GetPublicQueuesByCategoryund GetPublicQueuesByMachine.Specific methods for filtering by queue label, category, or server location are the GetPublicQueuesByLabel, GetPublicQueuesByCategory, and GetPublicQueuesByMachine.

Die MessageQueueCriteria -Klasse ermöglicht es Ihnen, GetPublicQueues den Filter zu verfeinern, wenn Sie mit der-Methode verwendet wird.The MessageQueueCriteria class, when used with the GetPublicQueues method, allows you to refine your filter. Sie können Suchkriterien angeben, die GetPublicQueuesBynicht speziell durch eine der *-Methoden oder mehrere Kriterien adressiert wurden.You can specify search criteria not specifically addressed through one of the GetPublicQueuesBy* methods, or by multiple criteria. Sie können eine MessageQueueCriteria -Instanz an die GetPublicQueues -Methode übergeben, um z. b. nach Warteschlangen Erstellung oder Änderungs Zeiten, nach dem Computer, auf dem sich die Warteschlange befindet, nach der Warteschlangen Bezeichnung oder-Kategorie oder nach einer beliebigen Kombination dieser Eigenschaften zu suchen.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.

Beim Filtern nach mehreren Eigenschaften werden die Kriterien durch Anwenden des AND -Operators auf den Eigenschaften Satz gebildet.When filtering by multiple properties, the criteria are composed by applying the AND operator to the set of properties. Wenn Sie also einen Wert für die CreatedAfter -Eigenschaft in Verbindung mit der MachineName -Eigenschaft angeben, fordern Sie alle Warteschlangen an, die nach einer bestimmten Zeit erstellt wurden und sich auf einem bestimmten Computer befinden.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.

Wenn Sie eine Eigenschaft festlegen, legt die-Methode, die die-Eigenschaft festlegt, auch ein Flag fest, um anzugeben, dass Sie in den Filter eingeschlossen werden soll, den Sie entwickeln.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. Sie können keine einzelnen Eigenschaften aus dem Suchfilter entfernen.You cannot remove individual properties from the search filter. Stattdessen entfernen Sie alle Eigenschaften aus dem Filter, indem Sie ClearAllaufrufen, und legen dann die Eigenschaften, die Sie erstellen möchten, im Suchfilter fest.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. ClearAllsetzt alle Eigenschaften auf den Standardzustand "nicht festgelegt" zurück.ClearAll resets all properties into a "not set" default state.

Sie müssen eine Eigenschaft festlegen, bevor Sie versuchen, Sie zu lesen. Andernfalls wird eine Ausnahme ausgelöst.You must set a property before trying to read it; otherwise, an exception is thrown.

Konstruktoren

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

Initialisiert eine neue Instanz der MessageQueueCriteria-Klasse.Initializes a new instance of the MessageQueueCriteria class.

Eigenschaften

Category Category Category Category

Ruft die Kategorie ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.Gets or sets the category by which to filter queues in the network.

CreatedAfter CreatedAfter CreatedAfter CreatedAfter

Ruft die untere Grenze für Erstellungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.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

Ruft die obere Grenze für Erstellungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.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

Ruft die Bezeichnung ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.Gets or sets the label by which to filter queues in the network.

MachineName MachineName MachineName MachineName

Ruft den Computernamen ab, nach dem Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diesen fest.Gets or sets the computer name by which to filter queues in the network.

ModifiedAfter ModifiedAfter ModifiedAfter ModifiedAfter

Ruft die untere Grenze für Änderungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.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

Ruft die obere Grenze für Änderungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.Gets or sets the upper boundary of the queue modification date and time by which to filter queues on the network.

Methoden

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

Löscht alle Eigenschaften aus einem Filter und setzt alle Eigenschaftswerte zurück (Zustand "nicht festgelegt").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)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch