DataGridViewCell.Value プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DataGridViewCell.Value プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

このセルに関連付けられている値を取得または設定します。

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

Visual Basic (宣言)

Public Property Value As
 Object

Visual Basic (使用法)

Dim instance As DataGridViewCell
Dim value As Object

value = instance.Value

instance.Value = value

public Object Value { get; set;
 }

C++

public:
property Object^ Value {
    Object^ get ();
    void set (Object^ value);
}

/** @property */
public Object get_Value ()

/** @property */
public void set_Value (Object value)

JScript

public function get Value
 () : Object

public function set Value
 (value : Object)

プロパティ値
セルに表示されるデータを取得または設定します。既定値は null 参照 (Visual Basic では Nothing) です。

例外

例外の種類	条件
ArgumentOutOfRangeException	RowIndex が有効な範囲 (0 ～コントロールの行数 - 1) 内にありません。
InvalidOperationException	ColumnIndex が 0 未満です。これは、セルが行ヘッダーのセルであることを示します。

解説

別の値をセルに割り当てると、DataGridView コントロールの CellValueChanged イベントが発生します。

Value プロパティが、セルに格納されている実際のデータオブジェクトであるのに対し、FormattedValue プロパティは、データの書式指定済みの表現です。ValueType プロパティと FormattedValueType プロパティは、これらの値のデータ型にそれぞれ対応しています。

Value プロパティを設定すると、指定された値は、書式設定された表示用の値から、基になるセル値に自動変換されません。たとえば、セルに対して有効な DataGridViewCellStyle が無視されるため、Value を DataGridViewCellStyle.NullValue に設定すると、DataGridViewCellStyle.DataSourceNullValue のプロパティ値が生成されなくなります。

使用例

Value プロパティを使用してセルの内容を更新する方法を次のコード例に示します。次のコード例は、「方法 : Windows フォームの DataGridView コントロールの行を操作する」で示されている例の一部です。

Visual Basic

' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal
 sender As Object, _
    ByVal e As System.EventArgs) Handles
 Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer
 = 3

Private Sub UpdateStars(ByVal
 row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row,
 string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}