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 MessageQueue , llame al CreateCursor método para esa cola.

CursorSe usa con métodos como Peek(TimeSpan, Cursor, PeekAction) y Receive(TimeSpan, Cursor) cuando se 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.

Cuando se leen mensajes dentro de una transacción, Message Queue Server 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 está en una transacción, Message Queue Server 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 señalando 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)
Finalize()	Garantiza que el cursor se borra cuando se desecha el objeto.
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()