DataGridViewCell.Value プロパティ

定義

このセルに関連付けられている値を取得または設定します。Gets or sets the value associated with this cell.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Browsable(false)]
public object Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

プロパティ値

セルに表示されるデータを取得または設定します。Gets or sets the data to be displayed by the cell. 既定値は、null です。The default is null.

属性

例外

RowIndex が有効な範囲 (0 ~コントロールの行数 - 1) 内にありません。RowIndex is outside the valid range of 0 to the number of rows in the control minus 1.

ColumnIndex が 0 未満です。これは、セルが行ヘッダーのセルであることを示します。ColumnIndex is less than 0, indicating that the cell is a row header cell.

次のコード例では、Value プロパティを使用してセルの内容を更新する方法を示します。The following code example shows how to update a cell's contents with the Value property. この例は 次の方法で提供されるより大きなコード例の一部です。Windows フォーム DataGridView コントロールの行を操作します。This example is part of a larger code example provided in How to: Manipulate Rows in the Windows Forms DataGridView Control.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
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 );
}


// 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);
}
' 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

注釈

セルに別の値を割り当てると、DataGridView コントロールの CellValueChanged イベントが発生します。When you assign a different value to a cell, the CellValueChanged event of the DataGridView control is raised.

Value プロパティは、セルに含まれる実際のデータオブジェクトです。一方、FormattedValue プロパティは、データの書式設定された表現です。The Value property is the actual data object contained by the cell, whereas the FormattedValue property is the formatted representation of the data. ValueType プロパティと FormattedValueType プロパティは、これらの値のデータ型にそれぞれ対応します。The ValueType and FormattedValueType properties correspond to the data types of these values, respectively.

Value プロパティを設定した場合、指定した値は、書式設定された表示値から基になるセル値に自動的に変換されません。When you set the Value property, the specified value is not automatically converted from a formatted, display value to an underlying cell value. たとえば、セルに対して有効な DataGridViewCellStyle は無視されるため、ValueDataGridViewCellStyle.NullValue に設定しても、DataGridViewCellStyle.DataSourceNullValueのプロパティ値は返されません。For example, the DataGridViewCellStyle in effect for the cell is ignored, so setting Value to DataGridViewCellStyle.NullValue does not result in a property value of DataGridViewCellStyle.DataSourceNullValue.

適用対象

こちらもご覧ください