Cursor Klasse

Definition

Beim Lesen der Meldungen einer Warteschlange wird mit einem Cursor eine bestimmte Position in dieser MessageQueue beizubehalten.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
Vererbung
Cursor
Implementiert

Hinweise

Um einen Cursor für eine MessageQueueabzurufen, müssen Sie die CreateCursor -Methode für diese Warteschlange abrufen.To get a cursor for a MessageQueue, call the CreateCursor method for that queue.

Eine Cursor wird mit Peek(TimeSpan, Cursor, PeekAction) Methoden wie und Receive(TimeSpan, Cursor) verwendet, wenn Sie Nachrichten lesen müssen, die sich nicht am Anfang der Warteschlange befinden.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. Dies schließt das synchrone oder asynchrone Lesen von Nachrichten ein.This includes reading messages synchronously or asynchronously. Cursor müssen nicht verwendet werden, um nur die erste Nachricht in einer Warteschlange zu lesen.Cursors do not need to be used to read only the first message in a queue.

Beim Lesen von Nachrichten innerhalb einer Transaktion führt Message Queuing kein Rollback der Cursor Bewegung aus, wenn die Transaktion abgebrochen wird.When reading messages within a transaction, Message Queuing does not roll back cursor movement if the transaction is aborted. Nehmen wir beispielsweise an, es gibt eine Warteschlange mit zwei Nachrichten, a1 und a2.For example, suppose there is a queue with two messages, A1 and A2. Wenn Sie die Nachricht a1 während einer Transaktion entfernen, verschiebt Message Queuing den Cursor in die Meldung a2.If you remove message A1 while in a transaction, Message Queuing moves the cursor to message A2. Wenn die Transaktion jedoch aus irgendeinem Grund abgebrochen wird, wird die Nachricht a1 zurück in die Warteschlange eingefügt, aber der Cursor verweist weiterhin auf die Meldung 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.

Um den Cursor zu schließen, Closewird aufgerufen.To close the cursor, call Close.

Methoden

Close()

Schließt den Cursor und ermöglicht es Message Queuing, die zugeordneten Ressourcen freizugeben.Closes the cursor, allowing Message Queuing to release the associated resources.

Dispose()

Gibt alle vom Cursor verwendeten Ressourcen frei.Releases all resources used by the Cursor.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Finalize()
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch