DataGridViewCell.Value Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Bu hücreyle ilişkili değeri alır veya ayarlar.

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

Özellik Değeri

Object

Hücre tarafından görüntülenecek verileri alır veya ayarlar. Varsayılan değer: null.

Öznitelikler
BrowsableAttribute

Özel durumlar

ArgumentOutOfRangeException

RowIndex , denetimdeki satır sayısı eksi 1 olan geçerli 0 aralığının dışındadır.

InvalidOperationException

ColumnIndex 0'dan küçüktür ve hücrenin bir satır üst bilgi hücresi olduğunu gösterir.

Örnekler

Aşağıdaki kod örneği, bir hücrenin içeriğini özelliğiyle nasıl güncelleştireceklerini Value gösterir. Bu örnek, Nasıl yapılır: Windows Forms DataGridView Denetimindeki Satırları Düzenleme bölümünde sağlanan daha büyük bir kod örneğinin parçasıdır.

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

Açıklamalar

Bir hücreye farklı bir değer atadığınızda, CellValueChanged denetimin DataGridView olayı tetikler.

Value özelliği hücrenin içerdiği gerçek veri nesnesidir, özelliği ise FormattedValue verilerin biçimlendirilmiş gösterimidir. ValueType ve FormattedValueType özellikleri sırasıyla bu değerlerin veri türlerine karşılık gelir.

özelliğini ayarladığınızda Value , belirtilen değer otomatik olarak biçimlendirilmiş, görüntüleme değerinden temel alınan hücre değerine dönüştürülmez. Örneğin, DataGridViewCellStyle hücrenin in etkisi yoksayılır, bu nedenle ayarı ValueDataGridViewCellStyle.NullValue özelliği değerine DataGridViewCellStyle.DataSourceNullValueneden olmaz.

Şunlara uygulanır

Ayrıca bkz.