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)

適用対象

こちらもご覧ください