SetValue(Int32,Int32,Object) メソッド

指定したセルに値を設定します。

構文

Visual Basic (宣言)
C#

Public Overloads Sub SetValue( _
   ByVal rowIndex As Integer, _
   ByVal cellIndex As Integer, _
   ByVal value As Object _
)

public void SetValue( 
   int rowIndex,
   int cellIndex,
   object value
)

パラメータ

rowIndex: セルのオーナー行の0から始まるインデックスを指定するSystem.Int32。
cellIndex: セルのセルコレクション内での0から始まるインデックスを指定するSystem.Int32。
value: セルに設定する新しい値を指定するSystem.Object。

例外

例外	解説
System.ArgumentOutOfRangeException	rowIndexが0未満か、Rowの数 - 1を超えています。または cellIndexが0未満か、RowのCellの数 - 1を超えています。

解説

System.ArgumentOutOfRangeException

rowIndexが0未満か、Rowの数 - 1を超えています。

または

cellIndexが0未満か、RowのCellの数 - 1を超えています。

解説

このメソッドは、指定されたセルのCell.Valueを、セルをインスタンス化せずに設定します。

セルおよび行のインスタンス化について:

既定では、GcMultiRowに含まれるすべてのCellとRowはメモリを保有せず、その処理ロジックと描画はテンプレートRowおよびCellで実行されます。したがって、RowおよびCellで公開されているほとんどの仮想メソッドは、対応する処理ロジックを適切に実行できるように、SectionIndexパラメーターを受け取る必要があります。

一部の操作では、その実行後に特定のCellのデータを保存するため、該当するRowおよびCellをインスタンス化する必要があります（テンプレートとは異なるCellStyle.BackColorや、LinkLabelCellのLinkLabelCell.LinkVisitedプロパティなど）。RowまたはCellをインスタンス化するとより多くのメモリが必要となり、システムのパフォーマンスが低下する場合があるので、インスタンス化したメソッドやプロパティを使用することはできる限り避けてください。

以下のメソッド、プロパティ、またはアクションを使用すると、Rowがインスタンス化されます。
CurrentRowプロパティを通じて現在の行にアクセスするとき
RowCollection.Itemプロパティを通じて特定の行にアクセスするとき
RowCollection.CopyToメソッドによってRowCollectionをコピーするとき
反復子（foreach）によってRowCollectionのメンバにアクセスするとき
ユーザーがデタッチされた行を通じて新しい行にアクセスするとき
ユーザーが［Ctrl］+［Del］キーを押して1つ以上の行を削除するとき
フィルタ関数によって1つ以上の行を非表示にするとき
1つのセルをインスタンス化すると、親行もインスタンス化される

以下のメソッド、プロパティ、またはアクションを使用すると、Cellがインスタンス化されます。
CurrentCellプロパティを通じて現在のセルにアクセスするとき
Item(Int32,Int32)プロパティまたはItem(Int32,String)プロパティを通じて特定のセルにアクセスするとき
そのLinkLabelCell.TrackVisitedStateプロパティがtrueに設定された1つのLinkLabelCellをクリックするとき

以下のメソッドでは、CellまたはRowはインスタンス化されません。
GetValue(Int32,Int32)メソッドまたはSetValue(Int32,Int32,Object)メソッドを呼び出すことによってCell.Valueを取得または設定するとき
GetFormattedValue(Int32,Int32)メソッドを呼び出すことによってCell.FormattedValueを取得するとき
GetEditedFormattedValue(Int32,Int32)メソッドを呼び出すことによってCell.EditedFormattedValueを取得するとき
CurrentCellプロパティまたはCurrentRowプロパティではなく、CurrentCellPositionプロパティにアクセスするとき
データソースを通じてデータを変更するとき

注意:上記のリストは、RowおよびCellのインスタンス化に関連するすべてのメソッドを示すものではありません。詳細については、個々のメソッドとプロパティの説明を参照してください。

参照

GcMultiRow クラス
 GcMultiRow メンバ
 オーバーロード一覧
 GetValue(Int32,Int32) メソッド
 GetValue(Int32,String) メソッド
 Value プロパティ