DataGridViewCell.Value Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość skojarzona z tą komórką.
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, set
Public Property Value As Object
Wartość właściwości
Pobiera lub ustawia dane, które mają być wyświetlane przez komórkę. Wartość domyślna to null
.
- Atrybuty
Wyjątki
RowIndex znajduje się poza prawidłowym zakresem od 0 do liczby wierszy w kontrolce minus 1.
ColumnIndex wartość jest mniejsza niż 0, co oznacza, że komórka jest komórką nagłówka wiersza.
Przykłady
Poniższy przykład kodu pokazuje, jak zaktualizować zawartość komórki za Value pomocą właściwości . Ten przykład jest częścią większego przykładu kodu przedstawionego w temacie How to: Manipulate Rows in the Windows Forms DataGridView Control (Jak manipulować wierszami w kontrolce 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
Uwagi
Po przypisaniu innej wartości do komórki CellValueChanged jest zgłaszane zdarzenie kontrolki DataGridView .
Właściwość Value jest rzeczywistym obiektem danych zawartym w komórce, natomiast FormattedValue właściwość jest sformatowaną reprezentacją danych. Właściwości ValueType i FormattedValueType odpowiadają odpowiednio typom danych tych wartości.
Po ustawieniu właściwości określona Value wartość nie jest automatycznie konwertowana z sformatowanej wartości wyświetlanej na podstawową wartość komórki. Na przykład DataGridViewCellStyle efekt dla komórki jest ignorowany, więc ustawienie Value na DataGridViewCellStyle.NullValue wartość nie powoduje wartości właściwości .DataGridViewCellStyle.DataSourceNullValue
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla