DataGridViewCell.Value Propriedade

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)]
public object? Value { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Value : obj with get, set

Public Property Value As Object

Valor de Propriedade

Obtém ou define os dados para serem exibidos pela célula. A predefinição é null.

Atributos

BrowsableAttribute

Exceções

Exemplos

O seguinte exemplo de código mostra como atualizar o conteúdo de uma célula com a Value propriedade. Este exemplo faz parte de um exemplo de código mais amplo fornecido em Como: Manipular Linhas no Controlo Windows Forms DataGridView.

// 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

Observações

Quando atribui um valor diferente a uma célula, o CellValueChanged evento do DataGridView controlo é elevado.

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, respetivamente, aos tipos de dados destes valores.

Quando defines a Value propriedade, o valor especificado não é automaticamente convertido de um valor de exibição formatado para um valor de célula subjacente. Por exemplo, o DataGridViewCellStyle efeito in para a célula é ignorado, pelo que definir Value para DataGridViewCellStyle.NullValue não resulta num valor de propriedade de DataGridViewCellStyle.DataSourceNullValue.

Ver também

• DataGridView
• Tag
• ValueType
• FormattedValue
• CellValueChanged