DataGridViewCell.Value Propriété

Définition

Obtient ou définit la valeur associée à cette cellule.Gets or sets the value associated with this cell.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Browsable(false)]
public object Value { get; set; }
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.Gets or sets the data to be displayed by the cell. Par défaut, il s’agit de null.The default is null.

Attributs

Exceptions

RowIndex est en dehors de la plage valide comprise entre 0 et le nombre de lignes du contrôle moins 1.RowIndex is outside the valid range of 0 to the number of rows in the control minus 1.

ColumnIndex est inférieur à 0, ce qui indique que la cellule est une cellule d'en-tête de ligne.ColumnIndex is less than 0, indicating that the cell is a row header cell.

Exemples

L’exemple de code suivant montre comment mettre à jour le contenu d’une cellule avec la propriété Value.The following code example shows how to update a cell's contents with the Value property. Cet exemple fait partie d’un exemple de code plus large fourni dans Comment : manipuler des lignes dans le contrôle DataGridView Windows Forms.This example is part of a larger code example provided in 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 assignez une valeur différente à une cellule, l’événement CellValueChanged du contrôle DataGridView est déclenché.When you assign a different value to a cell, the CellValueChanged event of the DataGridView control is raised.

La propriété Value est l’objet de données réel contenu dans la cellule, tandis que la propriété FormattedValue correspond à la représentation mise en forme des données.The Value property is the actual data object contained by the cell, whereas the FormattedValue property is the formatted representation of the data. Les propriétés ValueType et FormattedValueType correspondent respectivement aux types de données de ces valeurs.The ValueType and FormattedValueType properties correspond to the data types of these values, respectively.

Lorsque vous définissez la propriété Value, la valeur spécifiée n’est pas automatiquement convertie à partir d’une valeur d’affichage mise en forme en une valeur de cellule sous-jacente.When you set the Value property, the specified value is not automatically converted from a formatted, display value to an underlying cell value. Par exemple, l' DataGridViewCellStyle en vigueur pour la cellule est ignorée. par conséquent, la définition de Value sur DataGridViewCellStyle.NullValue n’entraîne pas la valeur de propriété DataGridViewCellStyle.DataSourceNullValue.For example, the DataGridViewCellStyle in effect for the cell is ignored, so setting Value to DataGridViewCellStyle.NullValue does not result in a property value of DataGridViewCellStyle.DataSourceNullValue.

S’applique à

Voir aussi