MessageQueue.PeekByLookupId 方法

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

在 MSMQ 3.0 中引入。 查看队列中特定的消息。 消息可通过查询标识符来指定，也可以通过其相对于队首或队尾的位置来指定。

重载

PeekByLookupId(Int64)	在 MSMQ 3.0 中引入。 从非事务性队列中查看与给定查找标识符匹配的消息。
PeekByLookupId(MessageLookupAction, Int64)	在 MSMQ 3.0 中引入。 查看队列中特定的消息。 消息可通过查询标识符来指定，也可以通过其相对于队首或队尾的位置来指定。

PeekByLookupId(Int64)

在 MSMQ 3.0 中引入。 从非事务性队列中查看与给定查找标识符匹配的消息。

public:
 System::Messaging::Message ^ PeekByLookupId(long lookupId);

public System.Messaging.Message PeekByLookupId (long lookupId);

member this.PeekByLookupId : int64 -> System.Messaging.Message

Public Function PeekByLookupId (lookupId As Long) As Message

参数

lookupId

Int64

要查看的消息的 LookupId。

返回

Message

Message，其 LookupId 属性匹配传入的 lookupId 参数。

例外

PlatformNotSupportedException

未安装 MSMQ 3.0。

InvalidOperationException

未能找到具有指定 lookupId 的消息。

MessageQueueException

访问“消息队列”方法时出错。

注解

使用此方法可读取具有已知查找标识符的消息，而无需将其从队列中删除。 如果消息不在队列中，此方法将立即引发异常。

LookupId消息的 属性对于消息所在的队列是唯一的，因此队列中最多会有一条消息与给定lookupId参数匹配。

若要读取具有指定查找标识符的消息并将其从队列中删除，请使用 ReceiveByLookupId 方法。

下表显示了此方法是否在各种工作组模式下可用。

工作组模式	可用
本地计算机	是
本地计算机和直接格式名称	是
远程计算机	否
远程计算机和直接格式名称	是

另请参阅

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

在 MSMQ 3.0 中引入。 查看队列中特定的消息。 消息可通过查询标识符来指定，也可以通过其相对于队首或队尾的位置来指定。

public:
 System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);

public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);

member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.Message

Public Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Message

参数

action

MessageLookupAction

一个 MessageLookupAction 值，指定读取队列中消息的方式。 指定以下值之一：

MessageLookupAction.Current：查看由 lookupId 指定的消息。

MessageLookupAction.Next：查看由 lookupId 指定的消息的下一条消息。

MessageLookupAction.Previous：查看由 lookupId 指定的消息的前一条消息。

MessageLookupAction.First：查看队列中的第一条消息。 lookupId 参数必须设置为 0。

MessageLookupAction.Last：查看队列中的最后一条消息。 lookupId 参数必须设置为 0。

lookupId

Int64

要查看的消息的 LookupId 或者为 0。 访问队列中的第一条和最后一条消息时使用 0。

返回

Message

由传入的 action 和 lookupId 参数指定的 Message。

例外

PlatformNotSupportedException

未安装 MSMQ 3.0。

InvalidOperationException

未能找到具有指定 lookupId 的消息。

MessageQueueException

访问“消息队列”方法时出错。

InvalidEnumArgumentException

action 参数不是 MessageLookupAction 成员之一。

注解

使用此方法可读取具有已知查找标识符的消息，而无需将其从队列中删除。 如果消息不在队列中，此方法将立即引发异常。

LookupId消息的 属性对于消息所在的队列是唯一的，因此队列中最多会有一条消息与给定lookupId参数匹配。

若要读取具有指定标识符的消息并将其从队列中删除，请使用 ReceiveByLookupId 方法。

下表显示了此方法是否在各种工作组模式下可用。

工作组模式	可用
本地计算机	是
本地计算机和直接格式名称	是
远程计算机	否
远程计算机和直接格式名称	是

另请参阅

• LookupId
• ReceiveByLookupId