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

IModel.AddNewModelAt メソッド

名前空間: NextDesign.Core

説明

このインスタンスの指定されたフィールドに、追加位置を指定して指定されたクラスのインスタンスをフィールド値として追加します。
指定されたクラスが抽象クラスの場合でもインスタンス化を許容し、指定された位置にフィールド値として追加します。
指定するフィールドは、クラス型の所有フィールドでなければなりません。
なお、多重度が2以上のフィールドの多重度上限制約に違反しても例外はスローされません。

指定するクラス名は、フィールドのデータ型と互換する型を指定する必要があります。
また、あいまい一致とするときに、一致するクラスが複数ある場合、一番最初に見つかった型互換のあるクラスのインスタンスを追加します。

引数

名前説明
fieldNamestringフィールド名
null、または空文字列は指定できません。
classNamestringクラス名
クラスの名前、または完全修飾名を指定します。
null、または空文字列は指定できません。
directionstring追加方向
- "first" : 先頭
- "last" : 末尾
- "before" : 前
- "after" : 後
indexint追加基準位置
先頭位置を0とするインデックスを指定します。
direction の指定が "first"の場合は、インデックスの値に関係なく先頭に追加します。
direction の指定が"last"の場合は、インデックスの値に関係なく末尾に追加します。
direction の指定が "before"の場合は、指定された位置に、"after"の場合は、指定された位置の次の位置にインスタンスを追加します。
fuzzyboolclassName引数を、完全修飾名ではなくクラスの名前として扱うかどうか。
Falseの場合、完全修飾名がclassNameに一致するクラスを指定したものとして評価します。
Trueの場合、クラス名がclassNameに一致するクラスを指定したものとして評価します。

既定値はTrueです。

戻り値

例外

名前例外クラス説明
引数不正ExtensionArgumentExceptionfieldName、または className に null、または空文字列 を指定した場合
direction に既定の文字列以外の文字列が指定された場合
フィールドが見つからないExtensionFieldNotFoundException指定されたフィールドがこのインスタンスのメタクラスで見つからない場合
不正フィールドアクセスExtensionIllegalFieldAccessException多重度の上限が1のフィールドに対してこのメソッドを実行した場合
インデックス範囲不正ExtensionOutOfRangeExceptionindex に 負数が指定された場合
または、index に該当フィールドの要素数以上の値が指定された場合
指定フィールド不正ExtensionInvalidTypeException指定されたフィールドに設定できない値が指定された場合
- 指定されたフィールドが所有フィールドでない
- 指定されたフィールドのデータ型がクラス型でない
- 指定されたフィールドの型と指定されたクラスが互換しない
クラスが見つからないExtensionTypeNotFoundException指定されたクラスが見つからない場合
不正操作ExtensionInvalidOperationException自身が削除済みモデル、一時プロキシの場合
フィールド名に操作不可のフィールドが指定された場合
- プロダクトラインのフィーチャ割り当てフィールド
- System.Coreタグが付与されているフィールド