DataGridViewCell.Value DataGridViewCell.Value DataGridViewCell.Value DataGridViewCell.Value Property

Definición

Obtiene o establece el valor asociado a esta celda.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

Valor de propiedad

Obtiene o establece los datos que va a mostrar la celda.Gets or sets the data to be displayed by the cell. De manera predeterminada, es null.The default is null.

Excepciones

RowIndex está fuera del intervalo válido, que va desde 0 hasta el número de filas del control menos 1.RowIndex is outside the valid range of 0 to the number of rows in the control minus 1.

ColumnIndex es menor que 0, lo que indica que la celda es una celda de encabezado de fila.ColumnIndex is less than 0, indicating that the cell is a row header cell.

Ejemplos

En el ejemplo de código siguiente se muestra cómo actualizar el contenido de una Value celda con la propiedad.The following code example shows how to update a cell's contents with the Value property. Este ejemplo forma parte de un ejemplo de código más grande proporcionado en cómo: Manipular filas en el controlDataGridView 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

Comentarios

Cuando se asigna un valor diferente a una celda, se CellValueChanged genera el evento DataGridView del control.When you assign a different value to a cell, the CellValueChanged event of the DataGridView control is raised.

La Value propiedad es el objeto de datos real que contiene la celda, mientras FormattedValue que la propiedad es la representación con formato de los datos.The Value property is the actual data object contained by the cell, whereas the FormattedValue property is the formatted representation of the data. Las ValueType propiedades FormattedValueType y se corresponden con los tipos de datos de estos valores, respectivamente.The ValueType and FormattedValueType properties correspond to the data types of these values, respectively.

Cuando se establece la Value propiedad, el valor especificado no se convierte automáticamente de un valor de presentación con formato en un valor de celda subyacente.When you set the Value property, the specified value is not automatically converted from a formatted, display value to an underlying cell value. Por ejemplo, se DataGridViewCellStyle omite el en vigor para la celda, por lo Value que DataGridViewCellStyle.NullValue establecer en no produce un valor de propiedad DataGridViewCellStyle.DataSourceNullValuede.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.

Se aplica a

Consulte también: