Cursor Třída

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Používá Cursor se k udržování konkrétního umístění v MessageQueue určitém umístění při čtení zpráv fronty.

public ref class Cursor sealed : IDisposable

public sealed class Cursor : IDisposable

type Cursor = class
    interface IDisposable

Public NotInheritable Class Cursor
Implements IDisposable

Dědičnost

Object

Cursor

Implementuje

IDisposable

Poznámky

Pokud chcete získat kurzor pro danou frontu, zavolejte metodu pro danou MessageQueuefrontu CreateCursor .

A Cursor se používá s těmito metodami, jako Peek(TimeSpan, Cursor, PeekAction) a Receive(TimeSpan, Cursor) když potřebujete číst zprávy, které nejsou v přední části fronty. To zahrnuje synchronní nebo asynchronní čtení zpráv. Kurzory není nutné používat ke čtení pouze první zprávy ve frontě.

Při čtení zpráv v rámci transakce služba Řízení front zpráv nevrací pohyb kurzoru, pokud je transakce přerušena. Předpokládejme například, že existuje fronta se dvěma zprávami, A1 a A2. Pokud odeberete zprávu A1 v transakci, služba Řízení front zpráv přesune kurzor na zprávu A2. Pokud je však transakce přerušena z nějakého důvodu, zpráva A1 se vloží zpět do fronty, ale kurzor zůstává ukazující na zprávu A2.

Chcete-li zavřít kurzor, zavolejte Close.

Metody

Name	Description
Close()	Zavře kurzor, což umožňuje službě Řízení front zpráv uvolnit přidružené prostředky.
Dispose()	Uvolní všechny prostředky používané nástrojem Cursor.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• CreateCursor()