Cursor Classe

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Il Cursor est utilisé pour maintenir un emplacement spécifique dans un MessageQueue emplacement 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
Object
Cursor
Implémente
IDisposable

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) quand vous devez lire des messages qui ne sont pas au début de la file d’attente. Cela inclut la lecture de messages de manière synchrone ou asynchrone. 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 de messages dans une transaction, Message Queuing ne restaure pas le mouvement 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 lors d’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 inséré dans la file d’attente, mais le curseur reste pointant vers le message A2.

Pour fermer le curseur, appelez Close.

Méthodes

Nom Description
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 le 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()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

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

(Hérité de Object)

S’applique à

Voir aussi