DataGridViewDataErrorContexts Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje stan kontrolki powiązanej DataGridView z danymi, gdy wystąpił błąd danych.
To wyliczenie obsługuje bitową kombinację jego wartości składowych.
public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
[<System.Flags>]
type DataGridViewDataErrorContexts =
Public Enum DataGridViewDataErrorContexts
- Dziedziczenie
- Atrybuty
Pola
ClipboardContent | 16384 | Wystąpił błąd danych podczas kopiowania zawartości do Schowka. Ta wartość wskazuje, że nie można przekonwertować wartości komórki na ciąg. |
Commit | 512 | Wystąpił błąd danych podczas zatwierdzania zmian w magazynie danych. Ta wartość wskazuje, że nie można zatwierdzać danych wprowadzonych w komórce do bazowego magazynu danych. |
CurrentCellChange | 4096 | Wystąpił błąd danych, gdy kursor zaznaczenia został przeniesiony do innej komórki. Ta wartość wskazuje, że użytkownik wybrał komórkę, gdy poprzednio wybrana komórka miała warunek błędu. |
Display | 2 | Wystąpił błąd danych podczas wyświetlania komórki wypełnionej przez źródło danych. Ta wartość wskazuje, że wartość ze źródła danych nie może być wyświetlana przez komórkę lub że brakuje mapowania, które tłumaczy wartość ze źródła danych na komórkę. |
Formatting | 1 | Wystąpił błąd danych podczas próby sformatowania danych wysyłanych do magazynu danych lub ładowania z magazynu danych. Ta wartość wskazuje, że nie można poprawnie sformatować zmiany komórki. Nowa wartość komórki musi zostać poprawiona lub należy zmienić formatowanie komórki. |
InitialValueRestoration | 1024 | Wystąpił błąd danych podczas przywracania komórki do poprzedniej wartości. Ta wartość wskazuje, że komórka próbowała anulować edycję, a wycofanie wartości początkowej nie powiodło się. Taka sytuacja może wystąpić, jeśli formatowanie komórki zostało zmienione tak, aby było niezgodne z wartością początkową. |
LeaveControl | 2048 | Wystąpił błąd danych podczas utraty fokusu DataGridView . Ta wartość wskazuje, że DataGridView nie można zatwierdzić zmian użytkownika po utracie fokusu. |
Parsing | 256 | Wystąpił błąd danych podczas analizowania nowych danych. Ta wartość wskazuje, że DataGridView nie można przeanalizować nowych danych wprowadzonych przez użytkownika lub załadowanych z bazowego magazynu danych. |
PreferredSize | 4 | Wystąpił błąd danych podczas obliczania preferowanego rozmiaru komórki. Ta wartość wskazuje, że DataGridView nie można obliczyć preferowanej szerokości lub wysokości komórki podczas programowego zmieniania rozmiaru kolumny lub wiersza. Taka sytuacja może wystąpić, jeśli komórka nie może sformatować jej wartości. |
RowDeletion | 8 | Wystąpił błąd danych podczas usuwania wiersza. Ta wartość wskazuje, że bazowy magazyn danych zgłosił wyjątek, gdy wiersz związany z DataGridView danymi został usunięty. |
Scroll | 8192 | Wystąpił błąd danych podczas przewijania nowego regionu do widoku. Ta wartość wskazuje, że komórka z błędami danych przewijane do widoku programowo lub za pomocą paska przewijania. |
Przykłady
Poniższy przykład kodu ilustruje użycie tego typu. Ten przykład jest częścią większego przykładu dostępnego w temacie How to: Handle Errors That Occur During Data Entry in the Windows Forms DataGridView Control (Jak obsługiwać błędy występujące podczas wprowadzania danych w kontrolce DataGridView).
private void dataGridView1_DataError(object sender,
DataGridViewDataErrorEventArgs e)
{
// If the data source raises an exception when a cell value is
// commited, display an error message.
if (e.Exception != null &&
e.Context == DataGridViewDataErrorContexts.Commit)
{
MessageBox.Show("CustomerID value must be unique.");
}
}
Private Sub dataGridView1_DataError(ByVal sender As Object, _
ByVal e As DataGridViewDataErrorEventArgs) _
Handles dataGridView1.DataError
' If the data source raises an exception when a cell value is
' commited, display an error message.
If e.Exception IsNot Nothing AndAlso _
e.Context = DataGridViewDataErrorContexts.Commit Then
MessageBox.Show("CustomerID value must be unique.")
End If
End Sub
Uwagi
Elementy członkowskie tego wyliczenia mogą być łączone przy użyciu operacji bitowej OR do reprezentowania stanu powiązanego DataGridView z danymi, gdy wystąpił błąd danych. Jeśli na przykład użytkownik wprowadzi nieprawidłową wartość komórki (na przykład wprowadzenie nazwy w komórce, która oczekuje daty), a następnie wybierze inną komórkę, DataGridView program spróbuje zatwierdzić nieprawidłową wartość komórki. Gdy zatwierdzenie zakończy się niepowodzeniemDataError, wywoła zdarzenie, DataGridView którego Context właściwość będzie miała wartość Commit i CurrentCellChange.