Skip to content
Start free evaluation

PDComm.GemEquipmentSpoolConfiguration

Class

Represents the spool that GemEquipmentWorker.StartWithSpoolingAsync attaches to the equipment.

public sealed record GemEquipmentSpoolConfiguration

The start method copies the configuration before it returns. On the worker thread it calls GemEquipment.ConfigureSpooling and, when GemEquipmentSpoolConfiguration.LocalPolicy is set, GemEquipment.ConfigureLocalSpooling.

Parameters

NameDescription
OptionsThe spool limits.
CatalogThe primary messages that can be spooled, in order; empty to accept the catalog of an existing snapshot file.
PathThe path of the snapshot file, whose parent directory must exist, or null for an in-memory spool.
LocalPolicyThe local spooling policy, or null to keep the policy of a new spool (disabled) or of the loaded file.
SelectionsThe stream selections applied with LocalPolicy; not applied when it is null, but still checked against the limits.

Members

GemEquipmentSpoolConfiguration

Constructor

Represents the spool that GemEquipmentWorker.StartWithSpoolingAsync attaches to the equipment.

public GemEquipmentSpoolConfiguration(GemSpoolOptions Options, ReadOnlyMemory<GemSpoolMessageKey> Catalog, string? Path = null, GemSpoolPolicy? LocalPolicy = null, ReadOnlyMemory<GemSpoolSelection> Selections = default)

The start method copies the configuration before it returns. On the worker thread it calls GemEquipment.ConfigureSpooling and, when GemEquipmentSpoolConfiguration.LocalPolicy is set, GemEquipment.ConfigureLocalSpooling.

Parameters

NameDescription
OptionsThe spool limits.
CatalogThe primary messages that can be spooled, in order; empty to accept the catalog of an existing snapshot file.
PathThe path of the snapshot file, whose parent directory must exist, or null for an in-memory spool.
LocalPolicyThe local spooling policy, or null to keep the policy of a new spool (disabled) or of the loaded file.
SelectionsThe stream selections applied with LocalPolicy; not applied when it is null, but still checked against the limits.

Catalog

Property

The primary messages that can be spooled, in order; empty to accept the catalog of an existing snapshot file.

public ReadOnlyMemory<GemSpoolMessageKey> Catalog { get; init; }

LocalPolicy

Property

The local spooling policy, or null to keep the policy of a new spool (disabled) or of the loaded file.

public GemSpoolPolicy? LocalPolicy { get; init; }

Options

Property

The spool limits.

public GemSpoolOptions Options { get; init; }

Path

Property

The path of the snapshot file, whose parent directory must exist, or null for an in-memory spool.

public string? Path { get; init; }

Selections

Property

The stream selections applied with LocalPolicy; not applied when it is null, but still checked against the limits.

public ReadOnlyMemory<GemSpoolSelection> Selections { get; init; }