DataGridViewRowErrorTextNeededEventArgs Klasa

Definicja

Udostępnia dane dotyczące RowErrorTextNeeded zdarzenia kontrolki DataGridView .

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

Przykłady

Poniższy przykład kodu pokazuje użycie tego typu. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie zdarzenia RowErrorTextNeeded . Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub zdarzeń, które występują często, rozważ zastąpienie Show komunikatu ciągiem Console.WriteLine lub dołączeniem go do wielowierszowego TextBoxelementu .

Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu DataGridView o nazwie DataGridView1. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem RowErrorTextNeeded .

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

Uwagi

Zdarzenie RowErrorTextNeeded występuje tylko wtedy, gdy właściwość kontrolki DataGridViewDataSource jest ustawiona lub jej VirtualMode właściwość to true. Obsługa RowErrorTextNeeded zdarzenia jest przydatna, gdy chcesz określić błąd dla wiersza w zależności od jego stanu i wartości, które zawiera.

Podczas obsługi zdarzenia i określania RowErrorTextNeeded tekstu błędu w procedurze obsługi pojawia się błąd glyph w nagłówku wiersza, chyba że DataGridView.ShowRowErrors właściwość jest ustawiona na false. Gdy użytkownik przenosi wskaźnik myszy na glyph błędu, tekst błędu pojawia się w etykietce narzędzia.

Zdarzenie RowErrorTextNeeded występuje również za każdym razem, gdy zostanie pobrana wartość DataGridViewRow.ErrorText właściwości.

Za pomocą RowIndex właściwości można określić stan lub wartość wiersza i użyć tych informacji, aby zmienić lub zmodyfikować ErrorText właściwość. Ta właściwość jest inicjowana z wartością właściwości wiersza ErrorText , która zastępuje wartość zdarzenia.

Obsługa zdarzenia RowErrorTextNeeded podczas pracy z dużymi ilościami danych, aby uniknąć kar za wydajność ustawiania wartości wiersza ErrorText dla wielu wierszy. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące skalowania kontrolki Windows Forms DataGridView.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Właściwości

ErrorText

Pobiera lub ustawia tekst błędu dla wiersza.

RowIndex

Pobiera wiersz, który wzbudził RowErrorTextNeeded zdarzenie.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też