Cursor Clase

Definición

Se utiliza una clase Cursor para mantener una ubicación concreta en una MessageQueue cuando se leen los mensajes de la cola.A Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.

public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
    interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
Herencia
Cursor
Implementaciones

Comentarios

Para obtener un cursor para MessageQueue , llame al CreateCursor método para esa cola.To get a cursor for a MessageQueue, call the CreateCursor method for that queue.

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.A Cursor is used with such methods as Peek(TimeSpan, Cursor, PeekAction) and Receive(TimeSpan, Cursor) when you need to read messages that are not at the front of the queue. Esto incluye leer mensajes de forma sincrónica o asincrónica.This includes reading messages synchronously or asynchronously. No es necesario usar cursores para leer solo el primer mensaje de una cola.Cursors do not need to be used to read only the first message in a queue.

Cuando se leen mensajes dentro de una transacción, Message Queue Server no revierte el movimiento del cursor si se anula la transacción.When reading messages within a transaction, Message Queuing does not roll back cursor movement if the transaction is aborted. Por ejemplo, supongamos que hay una cola con dos mensajes, a1 y a2.For example, suppose there is a queue with two messages, A1 and A2. Si quita el mensaje a1 mientras se está en una transacción, Message Queue Server mueve el cursor al mensaje a2.If you remove message A1 while in a transaction, Message Queuing moves the cursor to message 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.However, if the transaction is aborted for any reason, message A1 is inserted back into the queue but the cursor remains pointing at message A2.

Para cerrar el cursor, llame a Close .To close the cursor, call Close.

Métodos

Close()

Cierra el cursor y permite que Message Queuing libere los recursos asociados.Closes the cursor, allowing Message Queuing to release the associated resources.

Dispose()

Libera todos los recursos que usa Cursor.Releases all resources used by the Cursor.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Finalize()

Garantiza que el cursor se borra cuando se desecha el objeto.Ensures that the cursor is cleared when the object is disposed.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también