Cursor 类

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

Cursor 用于在读取队列的消息时保持 MessageQueue 中的特定位置。

public ref class Cursor sealed : IDisposable

public sealed class Cursor : IDisposable

type Cursor = class
    interface IDisposable

Public NotInheritable Class Cursor
Implements IDisposable

若要获取的 MessageQueue游标，请为该队列调用 CreateCursor 方法。

Cursor当你需要读取不在队列前面的消息时，与等方法Peek(TimeSpan, Cursor, PeekAction)Receive(TimeSpan, Cursor)一起使用。这包括以同步或异步方式读取消息。游标不需要仅用于读取队列中的第一条消息。

读取事务中的消息时，如果事务中止，消息队列不会回滚游标移动。例如，假设有一个队列，其中包含两个消息 A1 和 A2。如果在事务中删除消息 A1，消息队列会将光标移动到消息 A2。但是，如果由于任何原因中止了事务，则消息 A1 将插入回队列，但游标仍指向消息 A2。

若要关闭游标，请调用 Close。