Język

Cursor Klasa

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Element A Cursor służy do obsługi określonej lokalizacji w MessageQueue obiekcie 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
Object
Cursor
Implementuje
IDisposable

Uwagi

Aby uzyskać kursor dla MessageQueueelementu , wywołaj metodę CreateCursor dla tej kolejki.

Element jest Cursor 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 synchronicznie lub asynchronicznie 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 wycofania ruchu kursora, jeśli transakcja zostanie 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 do komunikatu A2. Jeśli jednak transakcja zostanie przerwana z jakiegokolwiek powodu, komunikat A1 zostanie wstawiony z powrotem do kolejki, ale kursor pozostaje wskazujący na komunikat A2.

Aby zamknąć kursor, wywołaj metodę Close.

Metody

Nazwa Opis
Close()

Zamyka kursor, umożliwiając kolejkowanie komunikatów w celu zwolnienia skojarzonych zasobów.
Dispose()

Zwalnia wszystkie zasoby używane przez program Cursor.
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(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()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też