This generator will launch an event on each message inside a queue on a Message Queuing server (MSMQ). This generator use the MSMQEvent class. You can use the MSMQReceiver to dequeue message from event generated by a MSMQGenerator, this can be useful when using the Peek action.
See Service Configuration for detailled information to configure your service. You must declare this generator with the <generator> section inside the <generators> section. It will looks like :
<generator name="MyGeneratorName" type="LeCouteauSuisse.Components.MSMQGenerator,
LeCouteauSuisseComponents, Version=1.0.0.2, Culture=neutral, PublicKeyToken=8d1037c5df6d5bd0">
This component have some parameters inside the section <settings>. Each parameter is written with a <setting> section.
Key name | Mandatory | Default value | Description |
queueName | Yes | | The name of the queue (sample : ".\Private$\MyQueue"). |
delayPooling | No | 1000 | The delay in milli-second the generator will check if the service is stopping. |
action | No | Peek | Action to do when a message is available in the queue :
- Peek : Copy the message in the event without removing the message from the queue.
- Receive : Copy the message in the event and remove it from the queue.
|
neverTransactionalMessage | No | false | This option force the generator to use a transaction on the message when dequeuing. This option is available only if action is Receive and the queue accepts only transactions. Values are :
- true : don't use transaction on message
- false : use transaction on message
|
data | No | | Private data you want to add to each event generated. |