MessageQueue.PeekByLookupId 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在 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.MessagePublic Function PeekByLookupId (lookupId As Long) As Message参数
返回
Message，其 LookupId 属性匹配传入的 lookupId 参数。
例外
未安装 MSMQ 3.0。
未能找到具有指定 lookupId 的消息。
访问“消息队列”方法时出错。
注解
使用此方法可读取具有已知查找标识符的消息，而无需将其从队列中删除。 如果消息不在队列中，此方法将立即引发异常。
LookupId消息的 属性对于消息所在的队列是唯一的，因此队列中最多会有一条消息与给定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.MessagePublic 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。
返回
由传入的 action 和 lookupId 参数指定的 Message。
例外
未安装 MSMQ 3.0。
未能找到具有指定 lookupId 的消息。
访问“消息队列”方法时出错。
action 参数不是 MessageLookupAction 成员之一。
注解
使用此方法可读取具有已知查找标识符的消息，而无需将其从队列中删除。 如果消息不在队列中，此方法将立即引发异常。
LookupId消息的 属性对于消息所在的队列是唯一的，因此队列中最多会有一条消息与给定lookupId参数匹配。
若要读取具有指定标识符的消息并将其从队列中删除，请使用 ReceiveByLookupId 方法。
下表显示了此方法是否在各种工作组模式下可用。
| 工作组模式 | 可用 |
|---|---|
| 本地计算机 | 是 |
| 本地计算机和直接格式名称 | 是 |
| 远程计算机 | 否 |
| 远程计算机和直接格式名称 | 是 |
