GetEditedFormattedValue(Int32,String) メソッド

指定したセルの編集された書式設定値を取得します。

構文

Visual Basic (宣言)
C#

Public Overloads Function GetEditedFormattedValue( _
   ByVal rowIndex As Integer, _
   ByVal cellName As String _
) As Object

public object GetEditedFormattedValue( 
   int rowIndex,
   string cellName
)

パラメータ

rowIndex: セルの行インデックス。
cellName: セルの名前。

戻り値の型

指定したセルの編集された書式設定値を示すSystem.Object。

例外

例外	解説
System.ArgumentNullException	cellNameがnull 参照 (Visual Basicでは Nothing)またはString.Emptyです。
System.ArgumentException	cellNameがRow内のどのCellの名前とも一致しません。
System.ArgumentOutOfRangeException	rowIndexが0未満か、Rowの数 - 1を超えています。

解説

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

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

既定では、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 メンバ
 オーバーロード一覧
 EditedFormattedValue プロパティ