The C# API of Realm is incredibly simple because it leverages the power of LINQ for querying and the Fody weaver to transform plain C# class declarations into persistent objects.

The main classes you will use are:

Helper classes you may use are:

Querying and Sorting are provided on a Realm using standard LINQ syntax including Where and OrderBy.

Realm Overview Diagram

Documentation

The documentation can be found at realm.io/docs/dotnet/latest.

The API reference is located at realm.io/docs/dotnet/latest/api.

Source

Source is available on github.

Instructions on how to build from source are included in that repository's README.md.

Minimal Sample

This trivial sample shows the use of most of the classes mentioned above:

getting a Realm with default name
declaring a simple model with a single RealmObject class - notice how it uses standard types for properties
using a Transaction to create an object in the realm

Note that in most debugging situations the default Realm will be retained so if you run this sample fragment multiple times you should see the number created increase. This is on purpose so you are assured the database is being persisted between runs.

 using Realms;
 
 class Hero : RealmObject
 {
     public string SuperName { get; set; }
     public int SuperScore { get; set; }
 }
 
 /// put this code in an OnLoad or simple button-press handler
 
     var _realm = Realm.GetInstance();
     using (var trans = _realm.BeginWrite())
     {
         var hero = _realm.CreateObject<Hero>();
         hero.SuperName = "Thor";
         hero.SuperScore = 100;
         trans.Commit();
     }
     var numAwe = _realm.All<Hero>().Count();
     System.Diagnostics.Debug.WriteLine($"Created {numAwe} heroes");
     _realm.Close();

Problem reports and Feature requests

The github issue tracker can be used to report problems or make feature requests.