Realm数据库是SQLite、Core Data的替代品，跨平台、支持加密、更快的执行效率，不用写sql。
安装Realm
使用VS新建一个UWP项目，右键解决方案资源管理器中项目节点下的的引用节点，选择管理Nuget程序包，打开NuGet包管理器。切换到浏览标签，搜索Realm，选择第一项Realm，点击右侧的安装。
创建 FodyWeavers.xml 文件
在项目中，新建一个xml文件，命名为FodyWeavers.xml，文件属性保持默认，内容如下：
The Realm package contains everything you need to use Realm. It depends on Fodyweaver, responsible for turning your RealmObject subclasses into persisted ones.
目前更新项目之后发现现在的写法要改成下面这样，而且注意NuGet还要同时安装Fody，Realm.Fody。
创建至少一个RealmObject派生类
//User.cs
class User: RealmObject
{
[Realms.PrimaryKey]
public int Id { get; set; }
public string Name { get; set; }
public string Sex { get; set; }
public int Age { get; set; }
}
//Book.cs
class Book : RealmObject
{
[Realms.PrimaryKey]
public int Id { get; set; }
public string Name { get; set; }
}
Realm数据库基本操作
连接或创建数据库
//对Realm数据库进行配置，Test.relam为数据库文件名
var config = new RealmConfiguration("Test.realm");
//打印一下这个数据库文件实际的保存路径
System.Diagnostics.Debug.WriteLine($"{Windows.Storage.ApplicationData.Current.LocalFolder.Path}\\Test.relam");
//设置数据库中的表对应的实体类，这里设置数据库只有一个User表；如果不设置，默认所有派生自RealmObject的类都会在该数据库中生成对应表
config.ObjectClasses = new Type[] { typeof(User) };
//设置数据库加密密码，长度为固定的64 bytes
//config.EncryptionKey = new byte[64]
//{
// 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08,
// 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18,
// 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27, 0x28,
// 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38,
// 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48,
// 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58,
// 0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68,
// 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78
//};
//获取Relam实例
var realm = Realm.GetInstance(config);
插入记录
//插入记录
var mandUser = new User() { Id = 3, Name = "Mandarava", Sex = "M", Age = 66 };
realm.Write(() =>
{
realm.Add(new User() { Id = 1, Name = "Tom", Sex = "M", Age = 77 });
realm.Add(new User() { Id = 2, Name = "Jerry", Sex = "F", Age = 88 });
realm.Add(mandUser);
realm.Add(new User() { Id = 4, Name = "Jack", Sex = "M", Age = 99 });
});
更新记录
//更新记录
realm.Write(() => {
//更新mandUser的Sex字段
mandUser.Sex = "男";
//更新mandUser //因为这里的new User的Id=3,mandUser的Id也是3，Id是PrimaryKey，所以这里仍然更新mandUser
realm.Add(new User() { Id = 3, Name = "鳗驼螺", Sex = "Male", Age = 88 }, true);
});
查询记录
//查询记录
var users = realm.All().Where(user => user.Sex == "M");
foreach(var user in users)
{
System.Diagnostics.Debug.WriteLine($"{user.Id}\t{user.Name}\t{user.Sex}\t{user.Age}");
}
删除记录
//删除记录
realm.Write(() =>{
//删除指定的记录
realm.Remove(mandUser);
//删除满足条件的一组记录
var dusers = realm.All().Where(user => user.Sex == "M");
realm.RemoveRange(dusers);
});
注：Realm.Write方法都是基于事务处理的。
一些问题和解决方法
No RealmObjects 错误
如果在运行时出现下面的错误：
System.InvalidOperationException:“No RealmObjects. Has linker stripped them? See https://realm.io/docs/xamarin/latest/#linker-stripped-schema”
如果没有在项目中写任何RelamObject派生类，就会出现这个问题。实际上是config.ObjectClasses没有设置造成的。所以，至少需要创建一个RelamObject的派生类。
非自动属性问题
Realm只支持自动属性，如：
[Realms.PrimaryKey]
public int Id{get;set;}
如果写成下面这种常规属性的形式：
[Realms.PrimaryKey]
public int Id {
get { return id; }
set { id = value; }
}
private int id;
你会得到类似下面的错误：
Fody/RealmWeaver: User.Id has [PrimaryKey] applied, but it's not persisted, so those attributes will be ignored.
当然，你可能会说把
[Realms.PrimaryKey]去掉就行了。去掉是不会报错了，但这个属性仍然会被忽略，不会成为Realm数据库表的字段，因为根本问题不在于这个属性修饰符，而是它被视为it's not persisted。
那如果我们在设置属性的时候，确有要求需要做点额外操作（比如检查属性值是否符合要求），这种情况下只能写成非自动属性，比如：
public int Age {
get { return age; }
set { age = value >= 0 ? value : 0; }
}
private int age;
但非自动属性又不能被Realm持久化，那这种情况下该怎么办？
为解决这类问题，RealmObject提供了一个PropertyChanged事件，该事件在属性发生改变时被触发。所以，我们要检查某个属性值是否符合我们的要求，或者在属性设置时干点其它的事，属性仍然写成自动属性，然后可以去监听这个事件，在该事件中去检查属性合法性（或干点别的），如：
//User.cs
class User: RealmObject{
...
public int Age{ get;set; }
}
//App
var mandUser = new User() { Id = 3, Name = "Mandarava", Sex = "M" };
mandUser.PropertyChanged += (obj, evt) =>
{
var usr = obj as User;
switch (evt.PropertyName)
{
case nameof(User.Age): if (usr.Age < 0) usr.Age = 0; break;
default: break;
}
};
mandUser.Age = 66;
当然，你可能有很多个User实例，每个都要添加一个PropertyChanged事件，太麻烦；而且像上面的代码，你需要在监听PropertyChanged事件后，再去设置要监听的属性Age的值，否则就会错过监听。为避免这些麻烦，因为User类派生自RealmObject类，所以更好的做法是直接在User类中重写OnPropertyChanged事件，像这样：
//User.cs
protected override void OnPropertyChanged(string propertyName)
{
base.OnPropertyChanged(propertyName);
switch (propertyName)
{
case nameof(Age): if (Age < 0) Age = 0; break;
default: break;
}
}
当然，还有一种方法是建立二个属性来解决这个问题，其中一个必是自动属性（可以设为private）：
private int age { get; set; }
public int Age {
get { return age; }
set { age = value >= 0 ? value : 0; }
}
这样也可以达到目的。当然，这个方法的问题是最终数据库中年龄字段的名称变成了age，如果你说我一定要让字段名是Age，咋整？可以使用MapTo属性修饰符来限定持久化后的属性名称，像这样：
[Realms.MapTo("Age")]
private int age { get; set; }
Cannot modify managed objects outside of a write transaction 错误
从Realm数据库中取出的数据对象，或通过realm.Add已经加入到Realm数据库中的对象，在更新该对象的Realm字段值时，需要使用Realm.Write(Action)方法（或它的异步版方法）来更新。比如，在前文中，mandUser是通过new来创建的，然后它被加入到Realm数据库中，这之后，它就与这个数据库有关联了，要更新它的Realm字段，不能直接像这样：
mandUser.Sex = "男";
这种方式就会导致本错误的出现，必须使用下面的方式来更新：
realm.Write(() => {
mandUser.Sex = "男";
};
Write方法是基于事务的更新，这也是为什么错误信息显示为outside of a write transaction的原因。
那么，普通new出来的对象，与从Realm数据库中加载的数据对象有什么区别呢？ 这具体看这个对象的Realm属性值。所有派生自RealmObject的对象，都有Realm属性，如果这个属性值为null，表示这个对象并没有关联Realm数据库，一个对象刚new时，它的Realm属性值为null（你也可以直接用RealmObject.IsManaged来检测，检测结果为true就表示Realm不为null，这也就是出错信息中指出的所谓的managed objects）。这种情况下，如果使用realm.Write(Action)是没效果的（当然，它会改变这个对象的属性值，但与Realm数据库无交互），因为这条记录在realm关联的数据库中并不存在，需要先使用realm.Add方法来将它添加到数据库中，一旦添加后，这个对象的Realm属性值不再为null（事实上，它的实际值就是realm），已经与Realm数据库进行了关联（从Realm数据库中加载到的数据也一样），需要使用realm.Write(Action)来更新其Realm字段数据。
这里，realm和mandUser.Realm在这个示例中是同一个对象，我们可以使用realm.IsSameInstance(mandUser.Realm)来对二者进行检测是否相同，如果检测结果为false，那表示这二者不是关联的同一数据库，不能使用realm来更新mandUser，当然，你可以用mandUser.Realm.Write(Action)来更新它自己，但注意mandUser.Realm可能为null，如果它尚未关联Realm数据库。
如果想通过一个对象来更新一条已有记录，这里有一个方法Realm.Add(RealmObject, bool)。这个方法的主要功能显然是用来向数据库添加记录的，不过它的第二参数是表示如果记录已经存在是否更新它，这个方法的第一参数是一个RealmObject对象，这个对象并不要求它已经关联了数据库，也就是它的Realm属性值可以是null，这个时候，如果要用它去更新数据库中已有的记录，就要设置这个对象的标记为[Realms.PrimaryKey]属性的Realm字段，让这个字段的值与数据中的要更新的记录中的该字段值保持一致，这样在更新的时候（二参为true），就会在数据库中找到并更新该条记录，如前文的示例：
realm.Write(() => {
mandUser.Sex = "男";
//更新mandUser //因为这里的new User的Id=3,mandUser的Id也是3，Id是PrimaryKey，所以这里仍然更新mandUser
realm.Add(new User() { Id = 3, Name = "鳗驼螺", Sex = "Male", Age = 88 }, true);
});
Relam数据库管理工具
可以使用 Realm Studio 管理数据库文件，它是官方提供的一个跨平台Realm数据库管理工具。
参考
- Getting Started