DataGridViewDataErrorContexts Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt den Zustand eines datengebundenen DataGridView-Steuerelements beim Auftreten eines Datenfehlers dar.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
[<System.Flags>]
type DataGridViewDataErrorContexts =
Public Enum DataGridViewDataErrorContexts
- Vererbung
- Attribute
Felder
ClipboardContent | 16384 | Datenfehler beim Kopieren von Inhalt in die Zwischenablage. Dieser Wert gibt an, dass der Zellenwert nicht in eine Zeichenfolge umgewandelt werden konnte. |
Commit | 512 | Datenfehler beim Speichern von Änderungen im Datenspeicher. Dieser Wert gibt an, dass in eine Zelle eingegebene Daten nicht in den zugrunde liegenden Datenspeicher übernommen werden konnten. |
CurrentCellChange | 4096 | Datenfehler beim Bewegen des Auswahlcursors in eine andere Zelle. Dieser Wert gibt an, dass vom Benutzer eine Zelle ausgewählt wurde, während die zuvor ausgewählte Zelle eine Fehlerbedingung aufwies. |
Display | 2 | Datenfehler beim Anzeigen einer Zelle, die von einer Datenquelle gefüllt wurde. Dieser Wert gibt an, dass der Wert aus der Datenquelle nicht von der Zelle angezeigt werden kann oder dass eine Zuordnung fehlt, die den Wert aus der Datenquelle in die Zelle übersetzt. |
Formatting | 1 | Datenfehler beim Formatieren von Daten, die an einen Datenspeicher gesendet werden oder aus einem Datenspeicher geladen werden. Dieser Wert gibt an, dass eine Änderung an einer Zelle nicht ordnungsgemäß formatiert werden konnte. Entweder muss der neue Zellenwert korrigiert werden, oder die Formatierung der Zelle muss geändert werden. |
InitialValueRestoration | 1024 | Datenfehler beim Wiederherstellen des früheren Werts einer Zelle. Dieser Wert gibt an, dass ein Bearbeitungsvorgang für eine Zelle abgebrochen werden sollte und ein Fehler beim Zurücksetzen auf den Anfangswert aufgetreten ist. Dies kann nach einer Änderung der Zellformatierung auftreten, sodass diese nicht mit dem Anfangswert kompatibel ist. |
LeaveControl | 2048 | Datenfehler beim Entfernen des Fokus von DataGridView. Dieser Wert gibt an, dass die DataGridView nach dem Entfernen des Fokus keine Benutzeränderungen übernehmen konnte. |
Parsing | 256 | Datenfehler beim Analysieren neuer Daten. Dieser Wert gibt an, dass die DataGridView vom Benutzer eingegebene bzw. aus dem zugrunde liegenden Datenspeicher geladene neue Daten nicht analysieren konnte. |
PreferredSize | 4 | Datenfehler beim Berechnen der geeigneten Größe einer Zelle. Dieser Wert gibt an, dass die DataGridView die geeignete Breite oder Höhe einer Zelle bei der programmgesteuerten Größenänderung einer Spalte oder Zeile nicht berechnen konnte. Dies kann der Fall sein, wenn der Wert für die Zelle nicht formatiert werden konnte. |
RowDeletion | 8 | Datenfehler beim Löschen einer Zeile. Dieser Wert gibt an, dass der zugrunde liegende Datenspeicher beim Löschen einer Zeile durch eine datengebundene DataGridView eine Ausnahme ausgelöst hat, . |
Scroll | 8192 | Datenfehler beim Durchführen eines Bildlaufs in einen neuen Bereich. Dieser Wert gibt an, dass durch einen Bildlauf (programmgesteuert oder mithilfe der Schiebeleiste durchgeführt) eine Zelle mit Datenfehlern angezeigt wurde. |
Beispiele
Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Behandeln von Fehlern, die während der Dateneingabe im Windows Forms DataGridView-Steuerelement auftreten, verfügbar ist.
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
Hinweise
Member dieser Enumeration können mithilfe des bitweisen OR-Vorgangs kombiniert werden, um den Zustand einer datengebundenen DataGridView Instanz darzustellen, wenn ein Datenfehler aufgetreten ist. Wenn ein Benutzer beispielsweise einen ungültigen Zellwert eingibt (z. B. einen Namen in eine Zelle eingibt, die ein Datum erwartet) und dann eine andere Zelle auswählt, versucht der DataGridView , den ungültigen Zellwert zu committen. Wenn der Commit fehlschlägt, löst das DataGridView ein Ereignis aus DataError , dessen Context Eigenschaft den Wert Commit und CurrentCellChange aufweist.