DataGridViewCell.Value Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

Object

Pobiera lub ustawia dane, które mają być wyświetlane przez komórkę. Wartość domyślna to null.

Atrybuty
BrowsableAttribute

Wyjątki

ArgumentOutOfRangeException

RowIndex znajduje się poza prawidłowym zakresem od 0 do liczby wierszy w kontrolce minus 1.

InvalidOperationException

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ż