Udostępnij za pośrednictwem


DataGridViewDataErrorContexts Wyliczenie

Definicja

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

Dotyczy

Zobacz też