DataGridViewCell.Value Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el valor asociado a esta celda.

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

Valor de propiedad

Object

Obtiene o establece los datos que va a mostrar la celda. De manera predeterminada, es null.

Atributos

BrowsableAttribute

Excepciones

ArgumentOutOfRangeException

RowIndex está fuera del intervalo válido, que va desde 0 hasta el número de filas del control menos 1.

InvalidOperationException

ColumnIndex es menor que 0, lo que indica que la celda es una celda de encabezado de fila.

Ejemplos

En el ejemplo de código siguiente se muestra cómo actualizar el contenido de una celda con la Value propiedad . Este ejemplo forma parte de un ejemplo de código más grande que se proporciona en 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 genera el CellValueChanged evento del DataGridView control.

La Value propiedad es el objeto de datos real contenido en la celda, mientras que la FormattedValue propiedad es la representación con formato de los datos. Las ValueType propiedades y FormattedValueType corresponden a los tipos de datos de estos valores, respectivamente.

Cuando se establece la Value propiedad , el valor especificado no se convierte automáticamente de un formato, mostrar el valor en un valor de celda subyacente. Por ejemplo, se omite el DataGridViewCellStyle objeto en vigor para la celda, por lo que establecer ValueDataGridViewCellStyle.NullValue en no da como resultado un valor de propiedad de DataGridViewCellStyle.DataSourceNullValue.

Consulte también

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged