Create or Modify Counters

Use the CountersFor.Increment method to create a new Counter or modify an existing Counter's value.
If the Counter exists, Increment will add the specified number to the Counter's current value.
If the Counter doesn't exist, Increment will create it and set its initial value.
For all other CountersFor methods see this Overview.
In this page:

`Increment` usage

Flow:

Open a session.
Create an instance of CountersFor.
- Either pass CountersFor an explicit document ID, -or-
- Pass it an entity tracked by the session, e.g. a document object returned from session.Query or from session.Load.
Call CountersFor.Increment.
Call session.SaveChanges for the changes to take effect.

Note:

Modifying a Counter using Increment only takes effect when session.SaveChanges() is executed.
To decrease a Counter's value, pass the method a negative number to the Increment method.

Example

// 1. Open a session
using (var session = docStore.OpenSession())
{
  // 2. pass CountersFor's constructor a document ID  
  var documentCounters = session.CountersFor("products/1-C");

  // 3. Use `CountersFor.Increment`
  documentCounters.Increment("ProductLikes"); // Increase "ProductLikes" by 1, or create it with a value of 1
  documentCounters.Increment("ProductDislikes", 1); // Increase "ProductDislikes" by 1, or create it with a value of 1
  documentCounters.Increment("ProductPageViews", 15); // Increase "ProductPageViews" by 15, or create it with a value of 15
  documentCounters.Increment("DaysLeftForSale", -10); // Decrease "DaysLeftForSale" by 10, or create it with a value of -10

  // 4. Save changes to the session
  session.SaveChanges();
}

Syntax

void Increment(string counterName, long incrementValue = 1);

Parameter	Type	Description
`counterName`	string	Counter's name
`delta`	long	Increase Counter by this value. Default value is 1. For a new Counter, this number will be its initial value.

Increment usage​

Example​

Syntax​

`Increment` usage

Example

Syntax