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 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.
    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.NullValueDataGridViewCellStyle.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.

適用於

另請參閱