Freigeben über


Cursor Klasse

Definition

Beim Lesen der Meldungen einer Warteschlange wird mit einem Cursor eine bestimmte Position in dieser MessageQueue beizubehalten.

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, rufen Sie die CreateCursor -Methode für diese Warteschlange auf.

Ein Cursor wird mit solchen Methoden Peek(TimeSpan, Cursor, PeekAction) wie und Receive(TimeSpan, Cursor) verwendet, wenn Sie Nachrichten lesen müssen, die sich nicht an der Front der Warteschlange befinden. Dies schließt das synchrone oder asynchrone Lesen von Nachrichten ein. Cursor müssen nicht verwendet werden, um nur die erste Nachricht in einer Warteschlange zu lesen.

Beim Lesen von Nachrichten innerhalb einer Transaktion führt Message Queuing kein Rollback der Cursorbewegung durch, wenn die Transaktion abgebrochen wird. Angenommen, es gibt eine Warteschlange mit zwei Nachrichten, A1 und A2. Wenn Sie die Nachricht A1 während einer Transaktion entfernen, verschiebt Message Queuing den Cursor zur Nachricht A2. Wenn die Transaktion jedoch aus irgendeinem Grund abgebrochen wird, wird die Nachricht A1 wieder in die Warteschlange eingefügt, aber der Cursor zeigt weiterhin auf Die Nachricht A2.

Rufen Sie zum Schließen des Cursors auf Close.

Methoden

Close()

Schließt den Cursor und ermöglicht es Message Queuing, die zugeordneten Ressourcen freizugeben.

Dispose()

Gibt alle vom Cursor verwendeten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Finalize()

Stellt sicher, dass der Cursor gelöscht wird, wenn das Objekt entfernt wird.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen