Cursor Classe

Definizione

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

Un Cursor oggetto viene usato per mantenere una posizione specifica in un MessageQueue oggetto 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 oggetto 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. Non è necessario usare i cursori 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 esista una coda con due messaggi, A1 e A2. Se si rimuove il messaggio A1 durante 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 in corrispondenza del messaggio A2.

Per chiudere il cursore, chiamare Close.

Metodi

Nome Descrizione
Close()

Chiude il cursore, consentendo a Accodamento messaggi di rilasciare le risorse 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 il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche