DataGridViewCell.Value Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit la valeur associée à cette cellule.

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

Valeur de propriété

Object

Obtient ou définit les données à afficher par la cellule. La valeur par défaut est null.

Attributs
BrowsableAttribute

Exceptions

ArgumentOutOfRangeException

RowIndex est en dehors de la plage valide comprise entre 0 et le nombre de lignes du contrôle moins 1.

InvalidOperationException

ColumnIndex est inférieur à 0, ce qui indique que la cellule est une cellule d'en-tête de ligne.

Exemples

L’exemple de code suivant montre comment mettre à jour le contenu d’une cellule avec la Value propriété . Cet exemple fait partie d’un exemple de code plus volumineux fourni dans Guide pratique pour manipuler des lignes dans le contrôle 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

Remarques

Lorsque vous affectez une autre valeur à une cellule, l’événement CellValueChanged du DataGridView contrôle est déclenché.

La Value propriété est l’objet de données réel contenu par la cellule, tandis que la FormattedValue propriété est la représentation mise en forme des données. Les ValueType propriétés et FormattedValueType correspondent respectivement aux types de données de ces valeurs.

Lorsque vous définissez la Value propriété, la valeur spécifiée n’est pas automatiquement convertie d’une valeur d’affichage mise en forme en valeur de cellule sous-jacente. Par exemple, la DataGridViewCellStyle valeur en vigueur pour la cellule est ignorée. Par conséquent, la définition Value de sur DataGridViewCellStyle.NullValue n’entraîne pas la valeur de DataGridViewCellStyle.DataSourceNullValuela propriété .

S’applique à

Voir aussi