Cursor Класс

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Используется Cursor для поддержания определенного расположения при MessageQueue чтении сообщений очереди.

public ref class Cursor sealed : IDisposable

public sealed class Cursor : IDisposable

type Cursor = class
    interface IDisposable

Public NotInheritable Class Cursor
Implements IDisposable

Наследование

Object

Cursor

Реализации

IDisposable

Комментарии

Чтобы получить курсор для очереди MessageQueue, вызовите CreateCursor метод для этой очереди.

A Cursor используется с такими методами, как Peek(TimeSpan, Cursor, PeekAction) и Receive(TimeSpan, Cursor) когда требуется читать сообщения, которые не находятся в передней части очереди. Это включает в себя синхронное или асинхронное чтение сообщений. Курсоры не нужно использовать для чтения только первого сообщения в очереди.

При чтении сообщений в транзакции очередь сообщений не откатывает перемещение курсора, если транзакция прервана. Например, предположим, что есть очередь с двумя сообщениями, A1 и A2. При удалении сообщения A1 во время транзакции очередь сообщений перемещает курсор в сообщение A2. Однако если транзакция прервана по какой-либо причине, сообщение A1 вставляется обратно в очередь, но курсор остается указывающим на сообщение A2.

Чтобы закрыть курсор, вызовите Close.

Методы

Имя	Описание
Close()	Закрывает курсор, позволяя очереди сообщений освободить связанные ресурсы.
Dispose()	Освобождает все ресурсы, используемые параметром Cursor.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• CreateCursor()