DataGridViewRowCollection.AddCopy メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewRowCollection.AddCopy メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

指定したインデックスにある行を基準として新しい行を追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 AddCopy ( _
    indexSource As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As DataGridViewRowCollection
Dim indexSource As Integer
Dim returnValue As Integer

returnValue = instance.AddCopy(indexSource)

C#

public virtual int AddCopy (
    int indexSource
)

C++

public:
virtual int AddCopy (
    int indexSource
)

J#

public int AddCopy (
    int indexSource
)

JScript

public function AddCopy (
    indexSource : int
) : int

パラメータ

indexSource

新しい行の基準となる行のインデックス。

戻り値
新しい行のインデックス。

例外

例外の種類	条件
ArgumentOutOfRangeException	indexSource が 0 未満か、コレクションに含まれている行数以上です。
InvalidOperationException	関連付けられた DataGridView コントロールが次のいずれかのアクションを実行しているため、一時的に新しい行が追加できない状態にあります。 コントロールのすべてのセルを選択している。 選択範囲をクリアしている。 または このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラから呼び出されています。 CellEnter CellLeave CellValidating CellValidated RowEnter RowLeave RowValidated RowValidating または DataGridView の DataSource プロパティが null 参照 (Visual Basic では Nothing) ではありません。 または この操作を実行すると、固定されていない行の後に、固定された行が追加されます。

解説

新しい行の InheritedStyle プロパティの値は、indexSource にある行の InheritedStyle と同じです。AddCopy メソッドは、可能な場合は、DataGridViewRowCollection に共有行を追加します。共有行を追加できない場合、新しい行は非共有となります。詳細については、「Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

新しい行の追加時にコントロール内の行が自動的に並べ替えられることはありません。新しい行を並べ替えた上で正しい位置に挿入するには、DataGridView.RowsAdded イベント ハンドラで System.Windows.Forms.DataGridView.Sort メソッドを呼び出します。また、CellValueChanged イベント ハンドラで System.Windows.Forms.DataGridView.Sort メソッドを呼び出すことにより、セルがユーザーによって変更されたときに行を並べ替えることもできます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRowCollection クラス
DataGridViewRowCollection メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewRow クラス