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 метод для этой очереди.

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

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

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

Методы

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

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

• CreateCursor()