MessageQueueCriteria 类

定义

当执行查询时使用 MessageQueue 类的 GetPublicQueues() 方法筛选消息队列。

public ref class MessageQueueCriteria
public class MessageQueueCriteria
type MessageQueueCriteria = class
Public Class MessageQueueCriteria
继承
MessageQueueCriteria

示例

以下示例循环访问消息队列,并显示最后一天创建且存在于计算机“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

注解

MessageQueue 提供了许多方法,可用于筛选网络上的公共队列的搜索。 按队列标签、类别或服务器位置 GetPublicQueuesByLabel进行筛选的特定方法是 、 GetPublicQueuesByCategoryGetPublicQueuesByMachine

MessageQueueCriteria 方法一 GetPublicQueues 起使用时, 类允许你优化筛选器。 可以指定未通过 * 方法之 GetPublicQueuesBy一或多个条件专门解决的搜索条件。 可以将 实例传递到 MessageQueueCriteriaGetPublicQueues 方法中,以便按队列创建时间或修改时间、队列所在的计算机、队列标签或类别或这些属性的任意组合进行搜索。

按多个属性进行筛选时,通过将 运算符应用于 AND 属性集来构成条件。 因此,当为 CreatedAfter 属性指定值以及 MachineName 属性时,需要指定在指定时间后创建且驻留在特定计算机上的所有队列。

设置任何属性时,设置属性的方法也会设置一个标志,以指示应将其包含在所生成的筛选器中。 无法从搜索筛选器中删除单个属性。 而是通过调用 ClearAll从筛选器中删除所有属性,然后设置要构建到搜索筛选器中的属性。 ClearAll 将所有属性重置为“未设置”默认状态。

在尝试读取属性之前,必须设置属性;否则,将引发异常。

构造函数

MessageQueueCriteria()

初始化 MessageQueueCriteria 类的新实例。

属性

Category

获取或设置作为网络中队列的筛选依据的类别。

CreatedAfter

获取或设置队列创建日期和时间的下限,以此作为筛选网络上的队列的依据。

CreatedBefore

获取或设置队列创建日期和时间的上限,以此作为筛选网络上的队列的依据。

Label

获取或设置作为网络中队列的筛选依据的标签。

MachineName

获取或设置作为网络中队列的筛选依据的计算机名。

ModifiedAfter

获取或设置队列修改日期和时间的下限,以此作为筛选网络上的队列的依据。

ModifiedBefore

获取或设置队列修改日期和时间的上限,以此作为筛选网络上的队列的依据。

方法

ClearAll()

清除置入筛选器的所有属性,并将所有属性值设为“未设置”状态。

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅