Cursor Classe

Definizione

Un oggetto Cursor viene uitlizzato per mantenere una posizione specifica in un oggetto MessageQueue durante la lettura dei messaggi della coda.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
Ereditarietà
Cursor
Implementazioni

Commenti

Per ottenere un cursore per un MessageQueueoggetto, chiamare CreateCursor il metodo per la coda.To get a cursor for a MessageQueue, call the CreateCursor method for that queue.

Un Cursor viene usato con metodi come Peek(TimeSpan, Cursor, PeekAction) e Receive(TimeSpan, Cursor) quando è necessario leggere i messaggi che non si trovano all'inizio della coda.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. Ciò include la lettura dei messaggi in modo sincrono o asincrono.This includes reading messages synchronously or asynchronously. Non è necessario usare i cursori per leggere solo il primo messaggio in una coda.Cursors do not need to be used to read only the first message in a queue.

Quando si leggono i messaggi all'interno di una transazione, Accodamento messaggi non esegue il rollback dello spostamento del cursore se la transazione è stata interrotta.When reading messages within a transaction, Message Queuing does not roll back cursor movement if the transaction is aborted. Si supponga, ad esempio, che esista una coda con due messaggi, a1 e a2.For example, suppose there is a queue with two messages, A1 and A2. Se si rimuove il messaggio a1 durante una transazione, Accodamento messaggi sposta il cursore sul messaggio a2.If you remove message A1 while in a transaction, Message Queuing moves the cursor to message A2. Tuttavia, se la transazione viene interrotta per qualsiasi motivo, il messaggio a1 viene inserito nuovamente nella coda, ma il cursore rimane puntando al messaggio 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.

Per chiudere il cursore, chiamare Close.To close the cursor, call Close.

Metodi

Close()

Chiude il cursore, consentendo di rilasciare le risorse ad esso associate.Closes the cursor, allowing Message Queuing to release the associated resources.

Dispose()

Rilascia tutte le risorse usate da Cursor.Releases all resources used by the Cursor.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Finalize()
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche