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 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. Свойства ValueType иFormattedValueType соответствуют типам данных этих значений соответственно.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.

Применяется к

Дополнительно