Enum OutboxDeliveryGuarantee
Specifies the delivery guarantee level for outbox message processing.
public enum OutboxDeliveryGuarantee
- Extension Methods
Fields
AtLeastOnce = 0Batched completion with highest throughput and larger failure window.
Messages are read in batches, published, and then marked complete as a batch. If a failure occurs after publishing but before batch completion, all messages in the batch may be redelivered on restart.
Use when: High throughput is critical and handlers are idempotent.
Throughput: Highest (batch operations reduce database round-trips).
Failure window: Entire batch (could be 100+ messages).
MinimizedWindow = 1Individual completion with lower throughput and smaller failure window.
Each message is marked complete immediately after successful publish. If a failure occurs, only the current message may be redelivered.
Use when: Minimizing duplicate deliveries is more important than throughput.
Throughput: Lower (one database round-trip per message).
Failure window: Single message.
Remarks
This enum controls how the outbox processor handles message completion and the trade-offs between throughput, failure window, and delivery guarantees.
Throughput vs. Failure Window Trade-off: Higher throughput modes batch operations but increase the window during which failures could cause message redelivery. Lower throughput modes complete messages individually for tighter guarantees.