DataGridView.DefaultValuesNeeded Olay

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kullanıcı, varsayılan değerlerle doldurulabilmesi için yeni kayıtların satırını girdiğinde gerçekleşir.

public:
 event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;

public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;

member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler 

Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler 

Olay Türü

DataGridViewRowEventHandler

Örnekler

Aşağıdaki kod örneği, bu olayın nasıl işlenebileceğini göstermektedir. Örnekte, belirtilen sütunların hücreleri varsayılan değerlerle doldurulur. CustomerID sütunu için değer, benzersiz bir müşteri kimliği oluşturan ayrı bir yöntemden (uygulanmamış) alınır.

Bu örneği çalıştırmak için, sütun adlarını gerçek DataGridView bir denetimdeki sütun nesnelerinin adlarıyla değiştirin ve uygun varsayılan değerleri sağlayın. Sütunları ada göre belirtirken, sütun başlığı metnini değil sütun nesnesinin adını kullanmanız gerekir.

private void dataGridView1_DefaultValuesNeeded(object sender,
    System.Windows.Forms.DataGridViewRowEventArgs e)
{
    e.Row.Cells["Region"].Value = "WA";
    e.Row.Cells["City"].Value = "Redmond";
    e.Row.Cells["PostalCode"].Value = "98052-6399";
    e.Row.Cells["Country"].Value = "USA";
    e.Row.Cells["CustomerID"].Value = NewCustomerId();
}

Private Sub dataGridView1_DefaultValuesNeeded(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewRowEventArgs) _
    Handles dataGridView1.DefaultValuesNeeded

    With e.Row
        .Cells("Region").Value = "WA"
        .Cells("City").Value = "Redmond"
        .Cells("PostalCode").Value = "98052-6399"
        .Cells("Country").Value = "USA"
        .Cells("CustomerID").Value = NewCustomerId()
    End With

End Sub

Açıklamalar

Bu olay, kullanıcı satıra girdiğinde yeni kayıtların satırını doldurmanıza olanak tanır. Satırın ilk değerleri, her sütunun DefaultNewRowValueDataGridViewCell özelliği tarafından döndürülen özelliğinin CellTemplate özelliğinden gelir.

Veri bağlı modunda, veri bağlı sütunların tüm hücre değerleri dış veri kaynağında depolanır. Kullanıcı yeni kayıtların satırını girdiğinde, olay gerçekleşmeden önce DefaultValuesNeeded veri kaynağında yeni bir satır oluşturulur. Olay işleyicinizdeki özelliğini doldurduğunda DataGridViewRowEventArgs.Row , değerler doğrudan veri kaynağına eklenir.

Sanal modda, bu olay gerçekleştikten sonra olay CellValuePushed yeni satırdaki her hücre için gerçekleşir, böylece varsayılan değerleri özel veri deponuzda depolayabilirsiniz. Ardından, CellValueNeeded olay yeni satırdaki her hücre için gerçekleşir ve olayda CellValuePushed depoladığınız değerleri alır ve daha sonra görüntülenir.

Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.

Ayrıca bkz.

• DataGridView Denetimi (Windows Forms)