Listeners: What are listeners?

The concept of listeners provides users with a mechanism to perform custom actions, in response to operations taken in a session. The listener implements an interface whose methods are called when a particular action is executed on an entity or querying is run.

There are five types of available listeners:

• Document Conflict listeners (IDocumentConflictListener),
• Document Conversion listeners (IDocumentConversionListener)
• Document Delete listeners (IDocumentDeleteListener)
• Document Store listeners (IDocumentStoreListener)
• Document Query listeners (IDocumentQueryListener)

In order to add new listener you must register it in DocumentStore:

store.RegisterListener(new SampleDocumentStoreListener());

You can also set all your listeners at once by the following method:

store.SetListeners(new DocumentSessionListeners()
{
	StoreListeners = new IDocumentStoreListener[]
	{
		new SampleDocumentStoreListener()
	},
	DeleteListeners = new IDocumentDeleteListener[]
	{
		new SampleDocumentDeleteListener()
	}
});