DataGridViewCell.Value 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置与此单元格关联的值。

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

[System.ComponentModel.Browsable(false)]
public object Value { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Value : obj with get, set

Public Property Value As Object

属性值

Object

获取或设置该单元格要显示的数据。 默认值为 null。

属性

BrowsableAttribute

例外

ArgumentOutOfRangeException

RowIndex 不在有效范围（从 0 至控件中的行数减 1）内。

InvalidOperationException

ColumnIndex 小于 0，这表示该单元格为行标头单元格。

示例

下面的代码示例演示如何使用 Value 属性更新单元格的内容。 此示例是 How to： 操作 dataGridView 控件中Windows 窗体行中提供的更大代码示例的一部分。

// 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 。

属性 Value 是单元格包含的实际数据对象，而 FormattedValue 属性是数据的格式化表示形式。 ValueType和 FormattedValueType 属性分别对应于这些值的数据类型。

设置 Value 属性时，指定的值不会自动从格式化的显示值转换为基础单元格值。 例如， DataGridViewCellStyle 将忽略单元格的 实际上的 ，因此将 设置为 ValueDataGridViewCellStyle.NullValue 不会导致 属性值 DataGridViewCellStyle.DataSourceNullValue为 。

另请参阅

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged