DataGridViewCell.Value Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de waarde opgehaald of ingesteld die aan deze cel is gekoppeld.
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 ObjectWaarde van eigenschap
Hiermee worden de gegevens opgehaald of ingesteld die door de cel moeten worden weergegeven. De standaardwaarde is null.
- Kenmerken
Uitzonderingen
RowIndex valt buiten het geldige bereik van 0 tot het aantal rijen in het besturingselement min 1.
ColumnIndex is kleiner dan 0, waarmee wordt aangegeven dat de cel een rijkopcel is.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de inhoud van een cel bijwerkt met de Value eigenschap. Dit voorbeeld maakt deel uit van een groter codevoorbeeld in Hoe u kunt: Rijen bewerken in het Windows Forms DataGridView-besturingselement.
// 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
Opmerkingen
Wanneer u een andere waarde aan een cel toewijst, wordt de CellValueChanged gebeurtenis van het DataGridView besturingselement gegenereerd.
De Value eigenschap is het werkelijke gegevensobject in de cel, terwijl de FormattedValue eigenschap de opgemaakte weergave van de gegevens is. De ValueType en FormattedValueType eigenschappen komen respectievelijk overeen met de gegevenstypen van deze waarden.
Wanneer u de Value eigenschap instelt, wordt de opgegeven waarde niet automatisch geconverteerd van een opgemaakte weergavewaarde naar een onderliggende celwaarde. Het effect voor de cel wordt bijvoorbeeld DataGridViewCellStyle genegeerd, dus als u de instelling ValueDataGridViewCellStyle.NullValue instelt, resulteert dit niet in een eigenschapswaarde van DataGridViewCellStyle.DataSourceNullValue.
