メインコンテンツまでスキップ

IModel.RelateAt メソッド

名前空間: NextDesign.Core

説明

このインスタンスの指定されたフィールドで、追加位置を指定して与えられたモデルを関連づけて、追加した関連インスタンスを返します。

引数

名前説明
fieldNamestringフィールド名
null、または空文字列は指定できません。
oppositeIModel関連づけするモデル
null は指定できません。
directionstring関連づけフィールドにおける追加方向
- "first" : 先頭
- "last" : 末尾
- "before" : 前
- "after" : 後
indexint追加基準位置
先頭位置を0とするインデックスを指定します。
direction の指定が "first"の場合は、インデックスの値に関係なく先頭で関連づけます。
direction の指定が"last"の場合は、インデックスの値に関係なく末尾で関連づけます。
direction の指定が "before"の場合は、指定された位置に、"after"の場合は、指定された位置の次の位置でインスタンスを関連づけます。

戻り値

例外

名前例外クラス説明
引数不正ExtensionArgumentExceptionopposite に null を指定した場合
fieldName に null、または空文字列 を指定した場合
direction に既定の文字列以外の文字列が指定された場合
フィールドが見つからないExtensionFieldNotFoundException指定されたフィールドが移動先のインスタンスのメタクラスで見つからない場合
インデックス範囲不正ExtensionOutOfRangeExceptionindex に 負数が指定された場合
または、index に該当フィールドの要素数以上の値が指定された場合
不正操作ExtensionInvalidOperationException自身が削除済みモデル、一時プロキシの場合
フィールド名に操作不可のフィールドが指定された場合
- プロダクトラインのフィーチャ割り当てフィールド
- System.Coreタグが付与されているフィールド
- 所有フィールド
制約違反ExtensionIllegalFieldAccessException関連づけするモデルが指定したフィールドのデータ型と互換しない場合
関連づけにより、フィールドの多重度制約に違反する場合
関連づけにより、フィールドのパス制約に違反する場合
無効なモデルを指定したExtensionInvalidModelException関連づけするモデルに削除されたモデル、一時プロキシが指定された場合