Cursor Klasa

Definicja

Jest używany do obsługi określonej lokalizacji MessageQueue w trakcie odczytywania komunikatów w kolejce. CursorA Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.

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, CreateCursor Wywołaj metodę dla tej kolejki.To get a cursor for a MessageQueue, call the CreateCursor method for that queue.

Jest używany z takimi metodami Peek(TimeSpan, Cursor, PeekAction) jak Receive(TimeSpan, Cursor) i kiedy trzeba odczytać komunikaty, które nie znajdują się na początku kolejki. CursorA Cursor is used with such methods as Peek(TimeSpan, Cursor, PeekAction) and Receive(TimeSpan, Cursor) when you need to read messages that are not at the front of the queue. Obejmuje to odczytanie komunikatów synchronicznie lub asynchronicznie.This includes reading messages synchronously or asynchronously. Kursory nie muszą być używane do odczytywania tylko pierwszej wiadomości w kolejce.Cursors do not need to be used to read only the first message in a queue.

Podczas odczytywania wiadomości w ramach transakcji usługa kolejkowania komunikatów nie wycofa przenoszenia kursora, jeśli transakcja zostanie przerwana.When reading messages within a transaction, Message Queuing does not roll back cursor movement if the transaction is aborted. Załóżmy na przykład, że istnieje kolejka z dwoma komunikatami, a1 i a2.For example, suppose there is a queue with two messages, A1 and A2. W przypadku usunięcia komunikatu a1 w trakcie transakcji usługa kolejkowania komunikatów przenosi kursor do komunikatu a2.If you remove message A1 while in a transaction, Message Queuing moves the cursor to message A2. Jeśli jednak transakcja zostanie przerwana z dowolnego powodu, komunikat a1 zostanie wstawiony z powrotem do kolejki, ale kursor nadal będzie wskazywać komunikat a2.However, if the transaction is aborted for any reason, message A1 is inserted back into the queue but the cursor remains pointing at message A2.

Aby zamknąć kursor, wywołaj Closepolecenie.To close the cursor, call Close.

Metody

Close()

Zamyka kursor, dzięki czemu usługa kolejkowania komunikatów może zwolnić skojarzone zasoby.Closes the cursor, allowing Message Queuing to release the associated resources.

Dispose()

Zwalnia wszystkie zasoby używane przez Cursorprogram.Releases all resources used by the Cursor.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Finalize()
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też