DataGridViewCell.Value Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, связанное с этой ячейкой.
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)]
public object? Value { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.Value : obj with get, setPublic Property Value As ObjectЗначение свойства
Получает или задает данные, отображаемые в ячейке. Значение по умолчанию — null.
- Атрибуты
Исключения
Значение RowIndex находится вне допустимого диапазона от 0 до количества строк в элементе управления за вычетом 1.
Значение ColumnIndex меньше 0, свидетельствующее о том, что ячейка является ячейкой заголовка строки.
Примеры
В следующем примере кода показано, как обновить содержимое ячейки с помощью Value свойства . Этот пример является частью более крупного примера кода, приведенного в разделе Практическое руководство. Управление строками в элементе управления Windows Forms DataGridView.
// 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 значение в ячейке игнорируется, поэтому значение Value свойства не приводит к DataGridViewCellStyle.NullValue значению DataGridViewCellStyle.DataSourceNullValueсвойства .
