DataGridViewCell.Value Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

DataGridViewCell.cs

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. El valor predeterminado es null.

Atributos

BrowsableAttribute

Excepciones

ArgumentOutOfRangeException

RowIndex está fuera del intervalo válido de 0 al 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 proporcionado en Cómo: Manipular filas en el control DataGridView de formularios 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

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.

Al establecer la Value propiedad, el valor especificado no se convierte automáticamente de un formato y se muestra el valor en un valor de celda subyacente. Por ejemplo, el DataGridViewCellStyle efecto de la celda se omite, por lo que establecer DataGridViewCellStyle.NullValueValue en no da como resultado un valor de propiedad de DataGridViewCellStyle.DataSourceNullValue.

Consulte también

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged