Aracılığıyla paylaş

DataGridView.RowErrorTextNeeded Olay

  • Başvuru

Tanım

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

Bir satırın hata metni gerektiğinde gerçekleşir.

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler? RowErrorTextNeeded;
member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 
Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler

Olay Türü

DataGridViewRowErrorTextNeededEventHandler

Örnekler

Aşağıdaki kod örneğinde bu üyenin kullanımı gösterilmektedir. Örnekte, bir olay işleyicisi olayın oluşumunu RowErrorTextNeeded raporlar. Bu rapor, olayın ne zaman gerçekleştiğini öğrenmenize yardımcı olur ve hata ayıklamada size yardımcı olabilir. Birden çok olayı veya sık gerçekleşen olayları raporlamak için, iletisini ile Console.WriteLine değiştirmeyi MessageBox.Show veya çok satırlı TextBoxbir iletiye eklemeyi göz önünde bulundurun.

Örnek kodu çalıştırmak için, adlı DataGridView1bir tür DataGridView örneği içeren bir projeye yapıştırın. Ardından olay işleyicisinin olayla ilişkilendirildiğinden RowErrorTextNeeded emin olun.

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}

Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

Açıklamalar

Olay RowErrorTextNeeded yalnızca denetimin DataSource özelliği DataGridView ayarlandığında veya VirtualMode özelliği olduğunda truegerçekleşir. Bir satırın RowErrorTextNeeded durumuna ve içerdiği değerlere bağlı olarak hatasını belirlemek istediğinizde olayı işlemek yararlı olur.

Olayı işlediğinizde RowErrorTextNeeded ve işleyicide hata metni belirttiğinizde, özelliği olarak ayarlanmadığı falsesürece ShowRowErrors satır üst bilgisinde bir hata karakteri görüntülenir. Kullanıcı fare işaretçisini hata karakteri üzerine getirince, hata metni bir Araç İpucu'nda görünür.

Olay, RowErrorTextNeeded özelliğin DataGridViewRow.ErrorText değeri her alındığında da gerçekleşir.

Bir satırın DataGridViewRowErrorTextNeededEventArgs.RowIndex veya içerdiği değerlerin durumunu belirlemek için özelliğini kullanabilir ve özelliği değiştirmek veya değiştirmek için bu bilgileri kullanabilirsiniz DataGridViewRowErrorTextNeededEventArgs.ErrorText . Bu özellik, olay değerinin geçersiz kıldığı satır ErrorText özelliğinin değeriyle başlatılır.

RowErrorTextNeeded Birden çok satır için satır ErrorText değerini ayarlamanın performans cezalarını önlemek için büyük miktarda veriyle çalışırken olayı işleyin. Daha fazla bilgi için bkz. Windows Forms DataGridView Denetimini Ölçeklendirmeye Yönelik En İyi Yöntemler.

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

Şunlara uygulanır

Ayrıca bkz.