Cursor Classe

Definição

Espaço de Nomes:
System.Messaging
Assemblagem:
System.Messaging.dll

A Cursor é usado para manter uma localização específica em a 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

Observações

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

O A Cursor é usado com métodos como Peek(TimeSpan, Cursor, PeekAction) e Receive(TimeSpan, Cursor) quando precisa de ler mensagens que não estão no início da fila. Isto inclui ler mensagens de forma síncrona ou assíncrona. Os cursores não precisam de ser usados apenas para ler a primeira mensagem numa fila.

Ao ler mensagens dentro de uma transação, a Fila de Mensagens não reverte o movimento do cursor se a transação for abortada. Por exemplo, suponha que existe uma fila com duas mensagens, A1 e A2. Se remover a mensagem A1 durante uma transação, a Fila de Mensagens move o cursor para a mensagem A2. No entanto, se a transação for abortada por qualquer motivo, a mensagem A1 é inserida novamente na fila, mas o cursor mantém-se apontado para a mensagem A2.

Para fechar o cursor, chame Close.

Métodos

Name Description
Close()

Fecha o cursor, permitindo que a Fila de Mensagens liberte os recursos associados.
Dispose()

Liberta todos os recursos utilizados pelo Cursor.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Garante que o cursor é apagado quando o objeto é descartado.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também