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。 如果您在交易中移除訊息 A1，消息佇列會將游標移至訊息 A2。 不過，如果交易因任何原因而中止，訊息 A1 會插入佇列中，但游標仍指向訊息 A2。

若要關閉游標，請呼叫 Close。

方法

Close()	關閉游標，讓 Message Queuing 釋放相關聯的資源。
Dispose()	釋放 Cursor 所使用的所有資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• CreateCursor()