Cursor 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
Cursor A 用於在讀取佇列訊息時維持 a MessageQueue 中的特定位置。
public ref class Cursor sealed : IDisposablepublic sealed class Cursor : IDisposabletype Cursor = class
interface IDisposablePublic NotInheritable Class Cursor
Implements IDisposable- 繼承
-
Cursor
- 實作
備註
要取得 的 MessageQueue游標，呼叫 CreateCursor 該佇列的方法。
當你需要讀取不在排隊列前端的訊息時，會用 A Cursor 來處理以下方法Peek(TimeSpan, Cursor, PeekAction)Receive(TimeSpan, Cursor)。 這包括同步或非同步讀取訊息。 游標不必只讀取隊列中的第一個訊息。
在讀取交易中的訊息時，若交易中止，訊息佇列不會回滾游標移動。 例如，假設有一個佇列包含兩個訊息，A1 和 A2。 如果你在交易中移除訊息 A1，訊息排隊會將游標移到 A2。 然而，若交易因任何原因中止，訊息 A1 會被重新插入佇列，但游標仍指向訊息 A2。
要關閉游標，請呼叫 Close。
方法
| 名稱 | Description |
|---|---|
| Close() |
關閉游標，讓訊息排隊釋放相關資源。 |
| Dispose() |
釋放 Cursor所使用的所有資源。 |
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| Finalize() |
確保當物件被丟棄時，游標已被清除。 |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
