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. 默认值为 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 窗体 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.

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生效的单元格将被忽略,因此,设置ValueDataGridViewCellStyle.NullValue不会导致的属性值DataGridViewCellStyle.DataSourceNullValueFor 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.

适用于

另请参阅