DataGridViewCell.Value 屬性


取得或設定與這個儲存格相關聯的值。Gets or sets the value associated with this cell.

 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
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. 預設為 nullThe 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 Forms 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.
' 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, _

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. 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,因此將 Value 設定為 DataGridViewCellStyle.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.