Table of Contents

Struct SubscriptionDeliveryFault

Namespace
DotBoxD.Plugins.Runtime
Assembly
DotBoxD.Plugins.dll

A fault caught while delivering a published event to a subscription. Delivery runs on a background task and these faults are otherwise swallowed (so the game loop is never blocked or crashed by plugin code); the host observes them via PluginServer.Create(onSubscriptionFault: ...) to surface the failure in its log, so a misbehaving Subscriptions.On<T>().Where(...).RunLocal(...) chain is diagnosable instead of silently doing nothing.

public readonly record struct SubscriptionDeliveryFault : IEquatable<SubscriptionDeliveryFault>
Implements
Inherited Members

Constructors

SubscriptionDeliveryFault(Type, SubscriptionDeliveryStage, Exception)

A fault caught while delivering a published event to a subscription. Delivery runs on a background task and these faults are otherwise swallowed (so the game loop is never blocked or crashed by plugin code); the host observes them via PluginServer.Create(onSubscriptionFault: ...) to surface the failure in its log, so a misbehaving Subscriptions.On<T>().Where(...).RunLocal(...) chain is diagnosable instead of silently doing nothing.

public SubscriptionDeliveryFault(Type EventType, SubscriptionDeliveryStage Stage, Exception Exception)

Parameters

EventType Type

The event type whose delivery faulted.

Stage SubscriptionDeliveryStage

The delivery stage that threw.

Exception Exception

The exception that was caught.

Properties

EventType

The event type whose delivery faulted.

public Type EventType { get; init; }

Property Value

Type

Exception

The exception that was caught.

public Exception Exception { get; init; }

Property Value

Exception

Stage

The delivery stage that threw.

public SubscriptionDeliveryStage Stage { get; init; }

Property Value

SubscriptionDeliveryStage