Partager via


Cursor Classe

Définition

Cursor est utilisé pour conserver un emplacement spécifique dans MessageQueue lors de la lecture des messages de la file d'attente.

public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
    interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
Héritage
Cursor
Implémente

Remarques

Pour obtenir un curseur pour un MessageQueue, appelez la CreateCursor méthode pour cette file d’attente.

Un Cursor est utilisé avec des méthodes telles que Peek(TimeSpan, Cursor, PeekAction) et Receive(TimeSpan, Cursor) lorsque vous devez lire des messages qui ne se trouvent pas à l’avant de la file d’attente. Cela inclut la lecture synchrone ou asynchrone des messages. Les curseurs n’ont pas besoin d’être utilisés pour lire uniquement le premier message d’une file d’attente.

Lors de la lecture des messages au sein d’une transaction, Message Queuing ne restaure pas le déplacement du curseur si la transaction est abandonnée. Par exemple, supposons qu’il existe une file d’attente avec deux messages, A1 et A2. Si vous supprimez le message A1 dans une transaction, Message Queuing déplace le curseur vers le message A2. Toutefois, si la transaction est abandonnée pour une raison quelconque, le message A1 est réinséré dans la file d’attente, mais le curseur reste pointant vers le message A2.

Pour fermer le curseur, appelez Close.

Méthodes

Close()

Ferme le curseur, ce qui permet à Message Queuing de libérer les ressources associées.

Dispose()

Libère toutes les ressources utilisées par Cursor.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Finalize()

Garantit que le curseur est effacé lorsque l’objet est supprimé.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi