Cursor Classe

  • Referência

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)
Finalize()

Garante que o cursor seja limpo quando o objeto for descartado.
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)

Aplica-se a

Confira também