DataGridViewCell.Value Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta il valore associato a questa cella.

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

Valore della proprietà

Object

Ottiene o imposta i dati visualizzati dalla cella. Il valore predefinito è null.

Attributi
BrowsableAttribute

Eccezioni

ArgumentOutOfRangeException

La proprietà RowIndex non è inclusa nell'intervallo valido compreso tra 0 e il numero di righe nel controllo meno 1.

InvalidOperationException

La proprietà ColumnIndex è minore di 0, a indicare che la cella è un cella di intestazione di riga.

Esempio

Nell'esempio di codice seguente viene illustrato come aggiornare il contenuto di una cella con la Value proprietà . Questo esempio fa parte di un esempio di codice più grande fornito in Procedura: Modificare righe nel controllo 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

Commenti

Quando si assegna un valore diverso a una cella, viene generato l'evento CellValueChanged del DataGridView controllo.

La Value proprietà è l'oggetto dati effettivo contenuto dalla cella, mentre la proprietà è la FormattedValue rappresentazione formattata dei dati. Le ValueType proprietà e FormattedValueType corrispondono rispettivamente ai tipi di dati di questi valori.

Quando si imposta la Value proprietà, il valore specificato non viene convertito automaticamente da un valore di cella formattato e visualizzato in un valore di cella sottostante. Ad esempio, l'effetto per la cella viene ignorato, quindi l'impostazione DataGridViewCellStyleValue su DataGridViewCellStyle.NullValue non comporta un valore di proprietà di DataGridViewCellStyle.DataSourceNullValue.

Si applica a

Vedi anche