Cursor Classe

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Um Cursor é usado para manter um local específico em um MessageQueue ao ler as mensagens da fila.

public ref class Cursor sealed : IDisposable

public sealed class Cursor : IDisposable

type Cursor = class
    interface IDisposable

Public NotInheritable Class Cursor
Implements IDisposable

Herança

Object

Cursor

Implementações

IDisposable

Comentários

Para obter um cursor para um MessageQueue, chame o CreateCursor método para essa fila.

Um Cursor é usado com métodos como Peek(TimeSpan, Cursor, PeekAction) e Receive(TimeSpan, Cursor) quando você precisa ler mensagens que não estão na frente da fila. Isso inclui a leitura de mensagens de forma síncrona ou assíncrona. Os cursores não precisam ser usados para ler apenas a primeira mensagem em uma fila.

Ao ler mensagens em uma transação, o Enfileiramento de Mensagens não reverterá a movimentação do cursor se a transação for anulada. Por exemplo, suponha que haja uma fila com duas mensagens, A1 e A2. Se você remover a mensagem A1 durante uma transação, o Enfileiramento de Mensagens moverá o cursor para a mensagem A2. No entanto, se a transação for anulada por qualquer motivo, a mensagem A1 será inserida novamente na fila, mas o cursor permanecerá apontando para a mensagem A2.

Para fechar o cursor, chame Close.

Métodos

Close()	Fecha o cursor, permitindo que o Enfileiramento de Mensagens libere os recursos associados.
Dispose()	Libera todos os recursos usados pelo Cursor.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• CreateCursor()