DataGridViewCell.Value Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur nilai yang terkait dengan sel ini.

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

Nilai Properti

Object

Mendapatkan atau mengatur data yang akan ditampilkan oleh sel. Default adalah null.

Atribut: BrowsableAttribute

Pengecualian

ArgumentOutOfRangeException

RowIndex berada di luar rentang 0 yang valid hingga jumlah baris dalam kontrol dikurangi 1.

InvalidOperationException

ColumnIndex kurang dari 0, menunjukkan bahwa sel tersebut adalah sel header baris.

Contoh

Contoh kode berikut menunjukkan cara memperbarui konten sel dengan Value properti . Contoh ini adalah bagian dari contoh kode yang lebih besar yang disediakan dalam Cara: Memanipulasi Baris di Formulir Windows Kontrol 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

Keterangan

Saat Anda menetapkan nilai yang berbeda ke sel, CellValueChanged peristiwa DataGridView kontrol dinaikkan.

Properti Value adalah objek data aktual yang dimuat oleh sel, sedangkan FormattedValue properti adalah representasi data yang diformat. Properti ValueType dan FormattedValueType masing-masing sesuai dengan jenis data nilai-nilai ini.

Saat Anda mengatur Value properti , nilai yang ditentukan tidak dikonversi secara otomatis dari nilai yang diformat, menampilkan nilai menjadi nilai sel yang mendasar. Misalnya, efek DataGridViewCellStyle untuk sel diabaikan, sehingga pengaturan Value ke DataGridViewCellStyle.NullValue tidak menghasilkan nilai properti .DataGridViewCellStyle.DataSourceNullValue

Berlaku untuk

Bagikan melalui