リレーション

M には、次の 4 つの主要なリレーション タイプがあります。

• IChildToOneParentRelation
• IChildToManyParentsRelation
• IParentToOneChildRelation
• IParentToManyChildrenRelation

これらは最も厳密に型指定されたインターフェイスであり、ほとんどの場合に使用が推奨されます。 ただし、次のインターフェイスからも派生します (適切な場合)。

• IChildRelation
• IParentRelation
• IToOneRelation
• IToManyRelation
• IRelation

これらのインターフェイスは、多型に使用したり、型を厳密に指定していない場合はリレーションとすばやく連携したりすることができます。

[!注] リレーションのタイプは、リレーション定義のカーディナリティ、および必要とされるリレーション側のロールによって異なります。

リレーションはエンティティから取得できます。

[!注] プロパティ名の大文字と小文字は区別されません。

非汎用

タイプを指定せずにリレーションを取得するには、次のようにします。

IRelation relation = entity.GetRelation("AssetTypeToAsset");

汎用

型指定されたリレーションを取得するには、次のようにします (推奨されるアプローチ)。

IChildToManyParentsRelation relation = entity.GetRelation<IChildToManyParentsRelation>("AssetTypeToAsset");

[!注] リレーションが見つからないか場合や読み込まれていない場合は、null が返されます。 ただし、リレーションは遅延読み込みされることがあります。 詳細については、遅延読み込みを参照してください。

[!注] 読み込まれたすべてのリレーションは、IEntity.Relations プロパティを使用してアクセスすることができます。 これは、たとえば、LINQ を使用してリレーションをフィルタリングする場合に役立ちます。

使用しているリレーション インターフェイスによって、値の取得と設定にはさまざまな方法があります。 詳細な概要については、API docsを 参照してください。

非汎用

IRelation は、値に対する複数の操作をサポートします。 これが最も簡単にリレーションを操作する方法かもしれませんが、エラーは発生しやすくなります。 4 つの主なリレーション インターフェイスを使用し、それらのプロパティを使用することをお勧めします。

値を取得すると、常に ID のリストが返されます。 リレーションが IToManyRelation である場合は、リストには 0 個以上の値を含めることができます。 リレーションが IToOneRelation の場合は、空のリストまたは 1 つの値だけを返します。

IList<long> values = relation.GetIds();

値の設定は、ID のコレクションを渡すことによって行われます。 リレーションが IToManyRelation である場合は、リストには 0 個以上の値を含めることができます。 リレーションが IToOneRelation である場合は、リストには 0 個または 1 個の値を含めることができます。

relation.SetIds(ids);

リレーションの値をクリアするには、次のようにします。

relation.Clear();

汎用

厳密に型指定されたリレーションは、値をより適切にサポートします。 たとえば、IParentToManyChildrenRelation を取得します。

その子を取得するには、次のようにします。

IList<long> children = parentToManyChildrenRelation.Children;

子を追加するには、次のようにします。

parentToManyChildrenRelation.Children.Add(id);

別の便利な例としては、IToManyRelation があります。 .NET IList は一度に複数のアイテムの追加をサポートしていないので、IToManyRelation にこの機能が追加されています。

toManyRelation.AddRange(ids);

自己参照リレーションは、リレーションの両側で同じエンティティ定義を参照するリレーションです。 これにより、エンティティ上で同じ名前の 2 つのリレーション オブジェクトが作成されます。

非汎用的な方法でリレーションを取得する場合は、必要なロールを指定する必要があります。 そうしない場合は、InvalidOperationException がスローされます。一致するリレーションが 2 つあるからです。

IRelation relation = entity.GetRelation("SelfReferencingRelation", RelationRole.Child);

汎用的な方法でリレーションを取得する場合は、SDK がインターフェイスからロールを抽出します。 したがって、次の例は、通常の自己参照リレーションで機能します。

IChildToManyParentsRelation relation = entity.GetRelation<IChildToManyParentsRelation>("SelfReferencingRelation");

これにより、内部でロール Child が抽出されます。

[!警告] IRelation に汎用 GetRelation を渡さないでください。渡すと、SDK がロールを抽出できません。