Cursor Classe

Definição

Um Cursor é usado para manter um local específico em um MessageQueue ao ler as mensagens da fila.A Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.

public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
    interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
Herança
Cursor
Implementações

Comentários

Para obter um cursor para um MessageQueue, chame o CreateCursor método para essa fila.To get a cursor for a MessageQueue, call the CreateCursor method for that queue.

Um Cursor é usado com esses 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.A Cursor is used with such methods as Peek(TimeSpan, Cursor, PeekAction) and Receive(TimeSpan, Cursor) when you need to read messages that are not at the front of the queue. Isso inclui a leitura de mensagens de forma síncrona ou assíncrona.This includes reading messages synchronously or asynchronously. Os cursores não precisam ser usados para ler apenas a primeira mensagem em uma fila.Cursors do not need to be used to read only the first message in a queue.

Ao ler mensagens em uma transação, o serviço de enfileiramento de mensagens não reverterá o movimento do cursor se a transação for anulada.When reading messages within a transaction, Message Queuing does not roll back cursor movement if the transaction is aborted. Por exemplo, suponha que haja uma fila com duas mensagens, a1 e a2.For example, suppose there is a queue with two messages, A1 and A2. Se você remover a mensagem a1 enquanto estiver em uma transação, o enfileiramento de mensagens moverá o cursor para a mensagem a2.If you remove message A1 while in a transaction, Message Queuing moves the cursor to message A2. No entanto, se a transação for anulada por qualquer motivo, a mensagem a1 será inserida de volta na fila, mas o cursor permanecerá apontando para a mensagem a2.However, if the transaction is aborted for any reason, message A1 is inserted back into the queue but the cursor remains pointing at message A2.

Para fechar o cursor, chame Close.To close the cursor, call Close.

Métodos

Close()

Fecha o cursor, permitindo que o Enfileiramento de Mensagens libere os recursos associados.Closes the cursor, allowing Message Queuing to release the associated resources.

Dispose()

Libera todos os recursos usados pelo Cursor.Releases all resources used by the Cursor.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
Finalize()
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também