Cursor Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Element jest Cursor używany do obsługi określonej lokalizacji w obiekcie MessageQueue podczas odczytywania komunikatów kolejki.
public ref class Cursor sealed : IDisposable
public sealed class Cursor : IDisposable
type Cursor = class
interface IDisposable
Public NotInheritable Class Cursor
Implements IDisposable
- Dziedziczenie
-
Cursor
- Implementuje
Uwagi
Aby uzyskać kursor dla elementu MessageQueue, wywołaj metodę CreateCursor dla tej kolejki.
Element Cursor jest używany z takimi metodami jak Peek(TimeSpan, Cursor, PeekAction) i Receive(TimeSpan, Cursor) , gdy trzeba odczytywać komunikaty, które nie znajdują się przed kolejką. Obejmuje to synchroniczne lub asynchroniczne odczytywanie komunikatów. Kursory nie muszą być używane do odczytu tylko pierwszego komunikatu w kolejce.
Podczas odczytywania komunikatów w ramach transakcji kolejkowanie komunikatów nie powoduje wycofywania ruchu kursora, jeśli transakcja została przerwana. Załóżmy na przykład, że istnieje kolejka z dwoma komunikatami: A1 i A2. Jeśli usuniesz komunikat A1 podczas transakcji, kolejkowanie komunikatów przenosi kursor na komunikat A2. Jeśli jednak transakcja została przerwana z jakiegokolwiek powodu, komunikat A1 jest wstawiany z powrotem do kolejki, ale kursor pozostaje wskazujący na komunikat A2.
Aby zamknąć kursor, wywołaj metodę Close.
Metody
Close() |
Zamyka kursor, umożliwiając kolejkowanie komunikatów zwalnianie skojarzonych zasobów. |
Dispose() |
Zwalnia wszelkie zasoby używane przez element Cursor. |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
Finalize() |
Gwarantuje, że kursor zostanie wyczyszczone po usunięciu obiektu. |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |