DataGridViewCell.Value DataGridViewCell.Value DataGridViewCell.Value DataGridViewCell.Value Property

定義

このセルに関連付けられている値を取得または設定します。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

注釈

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

プロパティはセルFormattedValueに含まれる実際のデータオブジェクトであり、プロパティはデータの書式設定された表現です。 ValueThe Value property is the actual data object contained by the cell, whereas the FormattedValue property is the formatted representation of the data. プロパティValueTypeFormattedValueTypeプロパティは、これらの値のデータ型にそれぞれ対応します。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.

適用対象

こちらもご覧ください