関係 - .NET SDK

対 1 の関係

対 1 の関係とは、あるオブジェクトが 1 つの他のオブジェクトのみに特定の方法で関連付けられていることを意味します。 タイプが関連する Realm オブジェクトタイプであるプロパティを指定することにより、オブジェクト スキーマ内のオブジェクトタイプの 1 対 1 の関係を定義します。

public partial class Person : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset Birthdate { get; set; }
    public Dog? Dog { get; set; }
}
public partial class Dog : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string Breed { get; set; } = String.Empty;
}

直接関係をクエリするには、LINQ 構文を使用できます。 1 対 1 の関係をクエリする方法については、次の例を参照してください。

var fidosPerson = realm.All<Person>().FirstOrDefault(p => p.Dog == dog);

対多の関係

対多の関係とは、オブジェクトが複数のオブジェクトに特定の方法で関連していることを意味します。 タイプが関連する Realm オブジェクトタイプのIList<T>であるプロパティを指定することで、オブジェクトタイプの対多関係を定義します。 ゲッターのみを使用してIList<T>を定義します。 Realm はプロパティに初めてアクセスしたときにコレクション インスタンスを生成するため、コンストラクターで初期化する必要はありません。

// To add items to the IList<T>:
var person = new Person();
person.Dogs.Add(new Dog
{
    Name = "Caleb",
    Age = 7,
    Breed = "mutt"
});

public partial class Person : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset Birthdate { get; set; }
    public IList<Dog> Dogs { get; }
}
public partial class Dog : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string Breed { get; set; } = String.Empty;
}

var katieAndHerDogs = realm.All<Person>().
    Where(p => p.Name == "Katie")
    .FirstOrDefault();

逆の関係

逆の関係は、定義された 1 対多または 1 多の関係でオブジェクトを参照する他のオブジェクトにオブジェクトをリンクします。 関係の定義は一方向であるため、オブジェクトのモデルでプロパティを逆の関係として明示的に定義する必要があります。

たとえば、「ユーザーが多数のアイテムを持っている」という対多の関係では、「アイテムは 1 人のユーザーに属する」という逆関係は自動的に作成されません。 オブジェクトモデルで逆の関係を指定しない場合は、特定のアイテムに割り当てられているユーザーを検索するために別のクエリを実行する必要があります。

逆の関係を定義するには、オブジェクトモデルで getter 専用のIQueryable<T>プロパティを定義し、 Tは関係のソースタイプです。このプロパティを[Backlink(sourceProperty)]属性で注釈を付けます。ここで、「sourceProperty " は、関係の反対側にあるプロパティの名前です。 次の例は、「ユーザーが多くのアイテムを持っている」シナリオでこれを行う方法を示しています。

public partial class User : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; } = ObjectId.GenerateNewId();
    public string Name { get; set; }
    [Backlink(nameof(Item.Assignee))]
    public IQueryable<Item> Items { get; }
}
public partial class Item : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; } = ObjectId.GenerateNewId();
    public string Text { get; set; }
    public User? Assignee { get; set; }
}

この例では、次のことがわかります。

• アイテム オブジェクトのAssigneeプロパティは ユーザー オブジェクトです。

• ユーザー オブジェクトのItemsプロパティは関係を反転させ、 Assigneeプロパティにこの特定のユーザーを含むすべてのアイテム オブジェクトを参照します。

これにより、Item コレクションをクエリして、特定のユーザーに割り当てられたすべてのアイテムを取得できるようになります。

逆の関係をクエリするには、Linq は使用できません。 代わりに、string 述語を渡します。 次の例では、「oscirator」という単語を含むアイテムを持つすべてのユーザーを検索する方法を示しています。

var oscillatorAssignees = realm.All<User>()
    .Filter("Items.Text CONTAINS 'oscillator'").ToList();
foreach (User u in oscillatorAssignees)
{
    Console.WriteLine(u.Name);
}