Cursor Clase

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Se utiliza una clase Cursor para mantener una ubicación concreta en una MessageQueue cuando se leen los mensajes de la cola.

public ref class Cursor sealed : IDisposable

public sealed class Cursor : IDisposable

type Cursor = class
    interface IDisposable

Public NotInheritable Class Cursor
Implements IDisposable

Herencia

Object

Cursor

Implementaciones

IDisposable

Comentarios

Para obtener un cursor para , MessageQueuellame al CreateCursor método para esa cola.

Cursor Se usa con métodos como Peek(TimeSpan, Cursor, PeekAction) y Receive(TimeSpan, Cursor) cuando necesita leer mensajes que no están en la parte delantera de la cola. Esto incluye leer mensajes de forma sincrónica o asincrónica. No es necesario usar cursores para leer solo el primer mensaje de una cola.

Al leer mensajes dentro de una transacción, Message Queuing no revierte el movimiento del cursor si se anula la transacción. Por ejemplo, supongamos que hay una cola con dos mensajes, A1 y A2. Si quita el mensaje A1 mientras se encuentra en una transacción, Message Queuing mueve el cursor al mensaje A2. Sin embargo, si la transacción se anula por cualquier motivo, el mensaje A1 se vuelve a insertar en la cola, pero el cursor sigue apuntando al mensaje A2.

Para cerrar el cursor, llame a Close.

Métodos

Close()	Cierra el cursor y permite que Message Queuing libere los recursos asociados.
Dispose()	Libera todos los recursos que usa Cursor.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• CreateCursor()