MessageQueueCriteria Třída

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Filtruje fronty zpráv při provádění dotazu pomocí MessageQueue metody třídy GetPublicQueues() .

public ref class MessageQueueCriteria

public class MessageQueueCriteria

type MessageQueueCriteria = class

Public Class MessageQueueCriteria

Dědičnost

Object

MessageQueueCriteria

Příklady

Následující příklad iteruje fronty zpráv a zobrazí cestu ke každé frontě, která byla vytvořena za poslední den a která existuje v počítači "Můjpočítač".

#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

Poznámky

Třída MessageQueue poskytuje řadu metod, které umožňují filtrovat hledání veřejných front v síti. Konkrétní metody filtrování podle popisku fronty, kategorie nebo umístění serveru jsou GetPublicQueuesByLabel, GetPublicQueuesByCategorya GetPublicQueuesByMachine.

Třída MessageQueueCriteria při použití s metodou GetPublicQueues umožňuje upřesnit filtr. Můžete zadat kritéria hledání, která nejsou konkrétně adresována některou z GetPublicQueuesBymetod * nebo více kritérii. Instanci můžete předat MessageQueueCriteria do GetPublicQueues metody, aby bylo možné vyhledávat například podle doby vytvoření nebo úpravy fronty, počítače, na kterém se fronta nachází, popisku fronty nebo kategorie nebo jakékoli kombinace těchto vlastností.

Při filtrování podle více vlastností se kritéria skládají použitím operátoru AND na sadu vlastností. Když tedy zadáte hodnotu vlastnosti CreatedAfter společně s MachineName vlastností, požadujete všechny fronty, které byly vytvořeny po zadaném čase a které se nacházejí v konkrétním počítači.

Když nastavíte libovolnou vlastnost, metoda, která nastaví vlastnost, také nastaví příznak, který označuje, že by měla být zahrnuta do filtru, který vytváříte. Z vyhledávacího filtru nelze odebrat jednotlivé vlastnosti. Místo toho odeberete všechny vlastnosti z filtru voláním ClearAlla pak nastavíte vlastnosti, které chcete do vyhledávacího filtru zabudovat. ClearAll resetuje všechny vlastnosti do výchozího stavu "nenastavováno".

Musíte nastavit vlastnost před pokusem o čtení; v opačném případě dojde k výjimce.

Konstruktory

MessageQueueCriteria()

Inicializuje novou instanci MessageQueueCriteria třídy.

Vlastnosti

Category	Získá nebo nastaví kategorii, podle které chcete filtrovat fronty v síti.
CreatedAfter	Získá nebo nastaví dolní hranici vytvoření fronty datum a čas, podle kterého chcete filtrovat fronty v síti.
CreatedBefore	Získá nebo nastaví horní hranici vytvoření fronty datum a čas, podle kterého chcete filtrovat fronty v síti.
Label	Získá nebo nastaví popisek, podle kterého chcete filtrovat fronty v síti.
MachineName	Získá nebo nastaví název počítače, podle kterého chcete filtrovat fronty v síti.
ModifiedAfter	Získá nebo nastaví dolní hranici úpravy fronty datum a čas, podle kterého chcete filtrovat fronty v síti.
ModifiedBefore	Získá nebo nastaví horní hranici úpravy fronty datum a čas, podle kterého chcete filtrovat fronty v síti.

Metody

ClearAll()	Vymaže všechny vlastnosti z toho, aby byly zabudovány do filtru, a převede všechny hodnoty vlastností do stavu Nenastavováno.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• GetPublicQueues()
• GetPublicQueuesByMachine(String)
• GetPublicQueuesByLabel(String)
• GetPublicQueuesByCategory(Guid)