MSMQ Transport connection strings

Component: MSMQ Transport
NuGet Package NServiceBus (6.x)
The MSMQ connection string and any of its settings are optional. It is not required to set all values when specifying the connection string.
<configuration>
  <connectionStrings>
    <add name="NServiceBus/Transport"
         connectionString="cacheSendConnection=true;journal=false;deadLetter=true;useTransactionalQueues=true"/>
  </connectionStrings>
</configuration>
  • deadLetter: The deadLetter configuration parameter enables or disables the use of dead letter queues. The default value is true.
  • journal: MSMQ supports the concept of journaling. When journaling is active, a copy of each sent message is stored in the journal queue. The default value is false.
  • useTransactionalQueues: determines if the generated queues, or the existing ones, must be transactional queues. The default value is true. Setting this to false results in queues being created as non-transactional and messages being sent with MessageQueueTransactionType.None. Version 4 and above.
  • cacheSendConnection: instructs the underlying infrastructure to cache the connection to a remote queue and re-use it as needed instead of creating a new connection to send messages each time. The default value is true. This value is passed to the enableCache parameter of the MessageQueue constructor when sending a message. Version 4 and above.
  • timeToReachQueue: The time limit for the message to reach the destination queue, beginning from the time the message is sent. This sets the underlying Message.TimeToReachQueue. Format must be compatible with TimeSpan.Parse. The default value is TimeSpan.Infinite which will result in using the MSMQ system default of 4 days. Version 5.1 and above.

Last modified