DataGridViewRowErrorTextNeededEventArgs Sınıf

  • Başvuru

Tanım

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

Bir DataGridView denetimin RowErrorTextNeeded olayı için veri sağlar.

public ref class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
type DataGridViewRowErrorTextNeededEventArgs = class
    inherit EventArgs
Public Class DataGridViewRowErrorTextNeededEventArgs
Inherits EventArgs
Devralma
Object
EventArgs
DataGridViewRowErrorTextNeededEventArgs

Örnekler

Aşağıdaki kod örneği bu türün kullanımını gösterir. Örnekte, 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 Show veya iletiyi ç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 DataGridView denetim DataSource özelliği ayarlandığında veya VirtualMode özelliği olduğunda truegerçekleşir. Olayı işlemek, bir satırın RowErrorTextNeeded durumuna ve içerdiği değerlere bağlı olarak hatasını belirlemek istediğinizde yararlıdır.

Olayı işlediğinizde RowErrorTextNeeded ve işleyicide hata metni belirttiğinizde, özelliği olarak ayarlanmadığı DataGridView.ShowRowErrorsfalsesürece 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 RowIndex durumunu veya değerini belirlemek için özelliğini kullanabilir ve özelliği değiştirmek veya değiştirmek için bu bilgileri kullanabilirsiniz 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şleyebilir. 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.

Özellikler

ErrorText

Satır için hata metnini alır veya ayarlar.
RowIndex

Olayı tetikleyen RowErrorTextNeeded satırı alır.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.