Cursor Класс

Определение

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

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

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

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

Методы

Close()

Закрывает курсор, разрешая службе Message Queuing освободить связанные ресурсы.

Dispose()

Освобождает все ресурсы, занятые модулем Cursor.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Finalize()

Обеспечивает очистку курсора при удалении объекта.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

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