IModel.SetFieldAt メソッド
名前空間: NextDesign.Core
説明
このインスタンスの指定されたフィールドの指定されたインデックス位置に、指定された値を設定します。
指定されたフィールドに設定できない値が指定された場合は、例外がスローされます。
なお、フィールドの多重度上限制約、パス制約に違反しても例外はスローされません。
引数
| 名前 | 型 | 説明 |
|---|---|---|
| fieldName | string | フィールド名 null、または空文字列は指定できません。 |
| value | object | フィールドの値 |
| index | int | 位置 先頭位置を0とするインデックスを指定します。 |
戻り値
- void
例外
| 名前 | 例外クラス | 説明 |
|---|---|---|
| 引数不正 | ExtensionArgumentException | fieldName に null、または空文字列 を指定した場合 |
| フィールドが見つからない | ExtensionFieldNotFoundException | 指定されたフィールドがこのインスタンスのメタクラスで見つからない場合 |
| 不正フィールドアクセス | ExtensionIllegalFieldAccessException | 多重度の上限が1のフィールドに対してこのメソッドを実行した場合 |
| インデックス範囲不正 | ExtensionOutOfRangeException | index に 負数が指定された場合 または、index に該当フィールドの要素数以上の値が指定された場合 |
| フィールドの型と一致しない | ExtensionInvalidTypeException | value に対して、指定されたフィールドに設定できない値が指定された場合 - クラス型のフィールドにプリミティブ型の値や、列挙値が指定された - 互換のないクラス型が指定された |
| 不正操作 | ExtensionInvalidOperationException | 自身が削除済みモデル、一時プロキシの場合 フィールド名に操作不可のフィールドが指定された場合 - プロダクトラインのフィーチャ割り当てフィールド - System.Coreタグが付与されているフィールド |
| 循環参照 | ExtensionCircularReferenceException | クラス型の所有フィールドに対しての呼び出し時、引数 value にこのメソッドの呼び出し対象自身またはその祖先を指定した場合 |
| 無効なモデルを指定した | ExtensionInvalidModelException | フィールドの値に削除されたモデル、一時プロキシが指定された場合 |
注釈
フィールドの型によって設定できる値について
フィールドの型によって設定できる値が以下のように決まります。
プリミティブ型フィールド(整数、実数、真偽値、文字列、リッチテキスト)
本メソッドでは設定できません。
列挙型フィールド
本メソッドでは設定できません。
クラス型フィールド
クラス型のフィールドでは、IModelインタフェースのインスタンスおよびnullを設定できます。
IModel型の値が指定された場合、既に設定されていたモデルの代わりに、指定されたモデルを設定します。
このとき、フィールドが所有か参照かで動作が異なります。所有の場合、引数で指定されたモデルを、メソッド呼び出し元のモデルの子として移動します。また、既に設定されていたモデルを削除します。
参照の場合、引数で指定されたモデルとの間に参照関連を追加します。また、既に設定されていたモデルとの間に存在した参照関連を削除します。既に設定されていたモデル自体は削除されません。
nullが指定された場合、既に設定されていたモデルの設定解除のみ行います。
所有の場合、既に設定されていたモデルは削除します。
参照の場合、既に設定されていたモデルとの間に存在した参照関連を削除します。既に設定されていたモデル自体は削除されません。
nullが指定されたとき、指定番目の要素が削除され、後続の要素が前方に詰められます。