DataGridViewCell.Value Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewCell.cs

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)>]
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 de 0 au nombre de lignes dans le contrôle moins 1.

InvalidOperationException

ColumnIndex est inférieur à 0, indiquant 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 large fourni dans How to : Manipulate Rows in the Windows Forms DataGridView Control.

// 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 attribuez une valeur différente à 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 les types de données de ces valeurs correspondent respectivement.

Lorsque vous définissez la Value propriété, la valeur spécifiée n’est pas automatiquement convertie à partir d’un format, valeur d’affichage en valeur de cellule sous-jacente. Par exemple, l’effet de la cellule est ignoré. Par conséquent, le DataGridViewCellStyle paramètre Value à DataGridViewCellStyle.NullValue ne pas entraîner de valeur de propriété .DataGridViewCellStyle.DataSourceNullValue

Voir aussi

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged