Cursor Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Messaging
Assembly:
System.Messaging.dll

Un oggetto Cursor viene uitlizzato per mantenere una posizione specifica in un oggetto MessageQueue durante la lettura dei messaggi della coda.

public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
    interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
Ereditarietà
Object
Cursor
Implementazioni
IDisposable

Commenti

Per ottenere un cursore per un MessageQueueoggetto , chiamare il CreateCursor metodo per tale coda.

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. Ciò include la lettura dei messaggi in modo sincrono o asincrono. I cursori non devono essere usati per leggere solo il primo messaggio in una coda.

Durante la lettura dei messaggi all'interno di una transazione, Accodamento messaggi non esegue il rollback dello spostamento del cursore se la transazione viene interrotta. Si supponga, ad esempio, che sia presente una coda con due messaggi, A1 e A2. Se si rimuove il messaggio A1 in una transazione, Accodamento messaggi sposta il cursore nel messaggio A2. Tuttavia, se la transazione viene interrotta per qualsiasi motivo, il messaggio A1 viene inserito nuovamente nella coda, ma il cursore rimane puntato al messaggio A2.

Per chiudere il cursore, chiamare Close.

Metodi

Close()

Chiude il cursore, consentendo di rilasciare le risorse ad esso associate.
Dispose()

Rilascia tutte le risorse usate da Cursor.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Finalize()

Assicura che il cursore venga cancellato quando l'oggetto viene eliminato.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche