Cursor 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
A Cursor 用于在读取队列的消息时维护特定位置 MessageQueue 。
public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
- 继承
-
Cursor
- 实现
注解
若要获取游标, MessageQueue请调用 CreateCursor 该队列的方法。
A Cursor 与此类方法一起使用,以及Peek(TimeSpan, Cursor, PeekAction)Receive(TimeSpan, Cursor)何时需要读取不在队列前面的消息。 这包括同步或异步读取消息。 游标不需要用于只读队列中的第一条消息。
读取事务中的消息时,如果事务中止,消息队列不会回滚游标移动。 例如,假设有一个队列,其中包含两条消息 A1 和 A2。 如果在事务中删除消息 A1,消息队列会将光标移动到消息 A2。 但是,如果出于任何原因中止事务,消息 A1 将插入到队列中,但游标仍指向消息 A2。
若要关闭游标,请调用 Close。
方法
| 名称 | 说明 |
|---|---|
| Close() |
关闭游标,允许消息队列释放关联的资源。 |
| Dispose() |
释放该 Cursor命令使用的所有资源。 |
| Equals(Object) |
确定指定的对象是否等于当前对象。 (继承自 Object) |
| Finalize() |
确保释放对象时清除游标。 |
| GetHashCode() |
用作默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| MemberwiseClone() |
创建当前 Object的浅表副本。 (继承自 Object) |
| ToString() |
返回一个表示当前对象的字符串。 (继承自 Object) |