Cursor Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 : IDisposablepublic sealed class Cursor : IDisposabletype Cursor = class
interface IDisposablePublic NotInheritable Class Cursor
Implements IDisposable- Ereditarietà
-
Cursor
- Implementazioni
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) |
