LineTen.Messaging.Bus.AzureServiceBus
2.0.112
dotnet add package LineTen.Messaging.Bus.AzureServiceBus --version 2.0.112
NuGet\Install-Package LineTen.Messaging.Bus.AzureServiceBus -Version 2.0.112
<PackageReference Include="LineTen.Messaging.Bus.AzureServiceBus" Version="2.0.112" />
<PackageVersion Include="LineTen.Messaging.Bus.AzureServiceBus" Version="2.0.112" />
<PackageReference Include="LineTen.Messaging.Bus.AzureServiceBus" />
paket add LineTen.Messaging.Bus.AzureServiceBus --version 2.0.112
#r "nuget: LineTen.Messaging.Bus.AzureServiceBus, 2.0.112"
#:package LineTen.Messaging.Bus.AzureServiceBus@2.0.112
#addin nuget:?package=LineTen.Messaging.Bus.AzureServiceBus&version=2.0.112
#tool nuget:?package=LineTen.Messaging.Bus.AzureServiceBus&version=2.0.112
LineTen.Messaging.Bus.AzureServiceBus
Azure Service Bus transport for LineTen messaging v3. Implements the transport seam defined in
LineTen.Messaging.Abstractions. Register through LineTen.Messaging.DependencyInjection.
Registration
services.AddLineTenMessaging("service-name")
.AddBus<OrdersBus>(b => b
.UseAzureServiceBus(connectionString, new AzureServiceBusTransportOptions { /* optional */ })
.WithSubscriptionLimits(warn: 1500, fail: 1900));
UseAzureServiceBus<TBus>(string connectionString, AzureServiceBusTransportOptions? options = null).
The connection string must be non-empty; misconfiguration fails at host start.
Options
| Option | Default | Purpose |
|---|---|---|
MaxLockDuration |
5 minutes | Message lock renewal ceiling. |
PrefetchCount |
0 | Processor prefetch. |
ShutdownTimeout |
30 seconds | Drain window on stop. |
LockRenewalWarningThreshold |
0.5 | Fraction of lock duration at which a renewal warning is logged. |
SubscriptionLimits |
warn 1500 / fail 1900 | Per-topic subscription-count alarm. |
RetryOptions |
SDK defaults | ServiceBusRetryOptions passed to the SDK client. |
VerifyEntitiesOnStart |
true |
Reconcile and count subscriptions at start. Set false only against the emulator. |
Behaviour
- Publishes envelopes as
ServiceBusMessagewithMessageId,CorrelationIdand application properties (MessageType, schema version, user properties, W3C trace context). - Subscriptions are named deterministically by
SubscriptionNamer.Computeand their SQL filters reconciled at start. - Received messages are mapped back to the envelope;
IMessageContextexposesMessageId,CorrelationId,DeliveryCount,EnqueuedAtUtcand userProperties. Trace-context keys are removed fromProperties. - Dead-lettering moves the message to the entity's dead-letter sub-queue. The DLQ-side
DeadLetterContextreadsDeadLetterReason,DeadLetterErrorDescription,DeadLetterSource,DeliveryCount,EnqueuedTimeand the preserved nativeCorrelationId. - Publish failures surface immediately as exceptions. No write-ahead buffering.
Emulator
Entities on the Azure Service Bus emulator are static, defined in its Config.json. Precompute the
subscription names with SubscriptionNamer.Compute(serviceName, topic, messageTypeFqn, filterCanonicalForm)
and set VerifyEntitiesOnStart = false. Do not derive names by hand; segments are sanitised and truncated
to 16 characters and the suffix is the first 64 bits of a SHA-256.
Version notes
2.0.112
IMessageContext.CorrelationIdpopulated from the nativeCorrelationIdheader of the received message.DeadLetterContext.CorrelationIdpopulated from the same header on the dead-letter sub-queue.- Absent or non-Guid header yields
Guid.Empty; no value is fabricated.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Azure.Messaging.ServiceBus (>= 7.18.0)
- LineTen.Messaging.Abstractions (>= 2.0.112)
- LineTen.Messaging.DependencyInjection (>= 2.0.112)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.112 | 114 | 9/7/2026 |
| 2.0.111 | 120 | 7/13/2026 |
| 2.0.110 | 927 | 6/23/2026 |
| 2.0.109 | 151 | 6/19/2026 |
| 2.0.108 | 122 | 6/17/2026 |
| 2.0.107 | 151 | 6/12/2026 |
| 2.0.106 | 122 | 6/1/2026 |
| 2.0.105 | 286 | 6/1/2026 |
| 2.0.104 | 120 | 6/1/2026 |
| 2.0.103 | 119 | 5/28/2026 |
| 2.0.102 | 151 | 5/27/2026 |
| 2.0.101 | 120 | 5/21/2026 |
| 2.0.100 | 118 | 5/20/2026 |
| 2.0.99 | 105 | 5/18/2026 |
| 2.0.98 | 106 | 5/18/2026 |