DataGridViewCell.Value Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewCell.cs

Возвращает или задает значение, связанное с этой ячейкой.

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 помощью свойства. Этот пример является частью более крупного примера кода, предоставленного в разделе "Практическое руководство. Управление строками в элементе управления DataGridView в Windows Forms".

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

Комментарии

При назначении другого DataGridView значения ячейке CellValueChanged возникает событие элемента управления.

Это Value свойство является фактическим объектом данных, содержащимся в ячейке, тогда как FormattedValue свойство является форматированным представлением данных. FormattedValueType Свойства ValueType соответствуют типам данных этих значений соответственно.

При установке свойства указанное Value значение не преобразуется из отформатированного значения, отображаемое значение в базовое значение ячейки. Например, DataGridViewCellStyle эффект для ячейки игнорируется, поэтому параметр Value не приводит к значению DataGridViewCellStyle.NullValueDataGridViewCellStyle.DataSourceNullValueсвойства.

См. также раздел

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged