DataGridView.DefaultValuesNeeded Olay

Tanım

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;
public event System.Windows.Forms.DataGridViewRowEventHandler? DefaultValuesNeeded;
member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler 
Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler 

Olay Türü

Ö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.

Şunlara uygulanır

Ayrıca bkz.