Cursor クラス

定義

名前空間:
System.Messaging
アセンブリ:
System.Messaging.dll

Cursorは、キューのメッセージを読み取るときに、MessageQueue内の特定の場所を維持するために使用されます。

public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
    interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
継承
Object
Cursor
実装
IDisposable

注釈

MessageQueueのカーソルを取得するには、そのキューのCreateCursor メソッドを呼び出します。

Cursorは、キューの先頭にないメッセージを読み取る必要がある場合に、Peek(TimeSpan, Cursor, PeekAction)やReceive(TimeSpan, Cursor)などのメソッドで使用されます。 これには、メッセージの同期または非同期の読み取りが含まれます。 キュー内の最初のメッセージのみを読み取るためにカーソルを使用する必要はありません。

トランザクション内のメッセージを読み取るとき、トランザクションが中止された場合、メッセージ キューはカーソル移動をロールバックしません。 たとえば、A1 と A2 の 2 つのメッセージを含むキューがあるとします。 トランザクション中にメッセージ A1 を削除すると、メッセージ キューはカーソルをメッセージ A2 に移動します。 ただし、何らかの理由でトランザクションが中止された場合、メッセージ A1 はキューに挿入されますが、カーソルはメッセージ A2 を指し続けます。

カーソルを閉じるには、 Closeを呼び出します。

メソッド

名前 説明
Close()

カーソルを閉じ、メッセージ キューが関連付けられているリソースを解放できるようにします。
Dispose()

Cursorで使用されているすべてのリソースを解放します。
Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Finalize()

オブジェクトが破棄されるときにカーソルがクリアされるようにします。
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象

こちらもご覧ください