DataGridViewCell.Value Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

DataGridViewCell.cs

Obtém ou define o valor associado a esta célula.

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 da propriedade

Object

Obtém ou define os dados a serem exibidas pela célula. O padrão é null.

Atributos

BrowsableAttribute

Exceções

ArgumentOutOfRangeException

RowIndex está fora do intervalo válido de 0 ao número de linhas no controle menos 1.

InvalidOperationException

ColumnIndex é menor que 0, indicando que a célula é uma célula de cabeçalho de linha.

Exemplos

O exemplo de código a seguir mostra como atualizar o conteúdo de uma célula com a Value propriedade . Este exemplo faz parte de um exemplo de código maior fornecido em 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

Comentários

Quando você atribui um valor diferente a uma célula, o CellValueChanged evento do DataGridView controle é gerado.

A Value propriedade é o objeto de dados real contido pela célula, enquanto a FormattedValue propriedade é a representação formatada dos dados. As ValueType propriedades e FormattedValueType correspondem aos tipos de dados desses valores, respectivamente.

Quando você define a Value propriedade, o valor especificado não é convertido automaticamente de um valor de exibição formatado para um valor de célula subjacente. Por exemplo, o DataGridViewCellStyle em vigor para a célula é ignorado, portanto, a configuração Value como DataGridViewCellStyle.NullValue não resulta em um valor de propriedade de DataGridViewCellStyle.DataSourceNullValue.

Confira também

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged