MessageQueueCriteria Klasse

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Filtert Meldungswarteschlangen beim Durchführen einer Abfrage mit der MessageQueue-Methode der GetPublicQueues()-Klasse.

public ref class MessageQueueCriteria

public class MessageQueueCriteria

type MessageQueueCriteria = class

Public Class MessageQueueCriteria

Vererbung: Object
MessageQueueCriteria

Beispiele

Das folgende Beispiel durchläuft Nachrichtenwarteschlangen und zeigt den Pfad jeder Warteschlange an, die am letzten Tag erstellt wurde und die auf dem Computer "MyComputer" vorhanden ist.

#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 bietet eine Reihe von Methoden, mit denen Sie Ihre Suche nach öffentlichen Warteschlangen im Netzwerk filtern können. Spezifische Methoden zum Filtern nach Warteschlangenbezeichnung, Kategorie oder Serverspeicherort sind , GetPublicQueuesByLabel GetPublicQueuesByCategoryund GetPublicQueuesByMachine.

Die MessageQueueCriteria -Klasse ermöglicht ihnen bei Verwendung mit der GetPublicQueues -Methode das Verfeinern des Filters. Sie können Suchkriterien angeben, die nicht speziell mit einer der GetPublicQueuesByMethoden * oder mit mehreren Kriterien behandelt werden. Sie können eine MessageQueueCriteria instance an die GetPublicQueues -Methode übergeben, um z. B. nach Warteschlangenerstellungs- oder Änderungszeiten, dem Computer, auf dem sich die Warteschlange befindet, der Warteschlangenbezeichnung oder -kategorie oder einer beliebigen Kombination dieser Eigenschaften zu suchen.

Beim Filtern nach mehreren Eigenschaften werden die Kriterien durch Anwenden des AND Operators auf den Satz von Eigenschaften zusammengesetzt. Wenn Sie also einen Wert für die Eigenschaft zusammen mit der CreatedAfter MachineName -Eigenschaft angeben, fragen Sie nach allen Warteschlangen, die nach einer angegebenen Zeit erstellt wurden und sich auf einem bestimmten Computer befinden.

Wenn Sie eine Eigenschaft festlegen, legt die -Methode, die die -Eigenschaft festlegt, auch ein Flag fest, das angibt, dass es in den zu erstellenden Filter eingeschlossen werden soll. Sie können keine einzelnen Eigenschaften aus dem Suchfilter entfernen. Stattdessen entfernen Sie alle Eigenschaften aus dem Filter, indem Sie aufrufen ClearAllund dann die Eigenschaften festlegen, die Sie in den Suchfilter integrieren möchten. ClearAll Setzt alle Eigenschaften in den Standardzustand "nicht festgelegt" zurück.

Sie müssen eine Eigenschaft festlegen, bevor Sie versuchen, sie zu lesen. andernfalls wird eine Ausnahme ausgelöst.

Konstruktoren

MessageQueueCriteria()

Initialisiert eine neue Instanz der MessageQueueCriteria-Klasse.

Eigenschaften

Category	Ruft die Kategorie ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.
CreatedAfter	Ruft die untere Grenze für Erstellungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.
CreatedBefore	Ruft die obere Grenze für Erstellungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.
Label	Ruft die Bezeichnung ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.
MachineName	Ruft den Computernamen ab, nach dem Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diesen fest.
ModifiedAfter	Ruft die untere Grenze für Änderungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.
ModifiedBefore	Ruft die obere Grenze für Änderungsdatum und -zeit ab, nach der Warteschlangen im Netzwerk gefiltert werden sollen, oder legt diese fest.

Methoden

ClearAll()	Löscht alle Eigenschaften aus einem Filter und setzt alle Eigenschaftswerte zurück (Zustand "nicht festgelegt").
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: