DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts Enum

Definition

Stellt den Zustand eines datengebundenen DataGridView-Steuerelements beim Auftreten eines Datenfehlers dar.Represents the state of a data-bound DataGridView control when a data error occurred.

Diese Enumeration weist ein FlagsAttribute-Attribut auf, die eine bitweise Kombination der Memberwerte zulässt.

public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
type DataGridViewDataErrorContexts = 
Public Enum DataGridViewDataErrorContexts
Vererbung
DataGridViewDataErrorContextsDataGridViewDataErrorContextsDataGridViewDataErrorContextsDataGridViewDataErrorContexts
Attribute

Felder

ClipboardContent ClipboardContent ClipboardContent ClipboardContent 16384

Datenfehler beim Kopieren von Inhalt in die Zwischenablage.A data error occurred when copying content to the Clipboard. Dieser Wert gibt an, dass der Zellenwert nicht in eine Zeichenfolge umgewandelt werden konnte.This value indicates that the cell value could not be converted to a string.

Commit Commit Commit Commit 512

Datenfehler beim Speichern von Änderungen im Datenspeicher.A data error occurred when committing changes to the data store. Dieser Wert gibt an, dass in eine Zelle eingegebene Daten nicht in den zugrunde liegenden Datenspeicher übernommen werden konnten.This value indicates that data entered in a cell could not be committed to the underlying data store.

CurrentCellChange CurrentCellChange CurrentCellChange CurrentCellChange 4096

Datenfehler beim Bewegen des Auswahlcursors in eine andere Zelle.A data error occurred when the selection cursor moved to another cell. Dieser Wert gibt an, dass vom Benutzer eine Zelle ausgewählt wurde, während die zuvor ausgewählte Zelle eine Fehlerbedingung aufwies.This value indicates that a user selected a cell when the previously selected cell had an error condition.

Display Display Display Display 2

Datenfehler beim Anzeigen einer Zelle, die von einer Datenquelle gefüllt wurde.A data error occurred when displaying a cell that was populated by a data source. 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.This value indicates that the value from the data source cannot be displayed by the cell, or a mapping that translates the value from the data source to the cell is missing.

Formatting Formatting Formatting Formatting 1

Datenfehler beim Formatieren von Daten, die an einen Datenspeicher gesendet werden oder aus einem Datenspeicher geladen werden.A data error occurred when trying to format data that is either being sent to a data store, or being loaded from a data store. Dieser Wert gibt an, dass eine Änderung an einer Zelle nicht ordnungsgemäß formatiert werden konnte.This value indicates that a change to a cell failed to format correctly. Entweder muss der neue Zellenwert korrigiert werden, oder die Formatierung der Zelle muss geändert werden.Either the new cell value needs to be corrected or the cell's formatting needs to change.

InitialValueRestoration InitialValueRestoration InitialValueRestoration InitialValueRestoration 1024

Datenfehler beim Wiederherstellen des früheren Werts einer Zelle.A data error occurred when restoring a cell to its previous value. 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.This value indicates that a cell tried to cancel an edit and the rollback to the initial value failed. Dies kann nach einer Änderung der Zellformatierung auftreten, sodass diese nicht mit dem Anfangswert kompatibel ist.This can occur if the cell formatting changed so that it is incompatible with the initial value.

LeaveControl LeaveControl LeaveControl LeaveControl 2048

Datenfehler beim Entfernen des Fokus von DataGridView.A data error occurred when the DataGridView lost focus. Dieser Wert gibt an, dass die DataGridView nach dem Entfernen des Fokus keine Benutzeränderungen übernehmen konnte.This value indicates that the DataGridView could not commit user changes after losing focus.

Parsing Parsing Parsing Parsing 256

Datenfehler beim Analysieren neuer Daten.A data error occurred when parsing new data. Dieser Wert gibt an, dass die DataGridView vom Benutzer eingegebene bzw. aus dem zugrunde liegenden Datenspeicher geladene neue Daten nicht analysieren konnte.This value indicates that the DataGridView could not parse new data that was entered by the user or loaded from the underlying data store.

PreferredSize PreferredSize PreferredSize PreferredSize 4

Datenfehler beim Berechnen der geeigneten Größe einer Zelle.A data error occurred when calculating the preferred size of a cell. 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.This value indicates that the DataGridView failed to calculate the preferred width or height of a cell when programmatically resizing a column or row. Dies kann der Fall sein, wenn der Wert für die Zelle nicht formatiert werden konnte.This can occur if the cell failed to format its value.

RowDeletion RowDeletion RowDeletion RowDeletion 8

Datenfehler beim Löschen einer Zeile.A data error occurred when deleting a row. Dieser Wert gibt an, dass der zugrunde liegende Datenspeicher beim Löschen einer Zeile durch eine datengebundene DataGridView eine Ausnahme ausgelöst hat, .This value indicates that the underlying data store threw an exception when a data-bound DataGridView deleted a row.

Scroll Scroll Scroll Scroll 8192

Datenfehler beim Durchführen eines Bildlaufs in einen neuen Bereich.A data error occurred when scrolling a new region into view. Dieser Wert gibt an, dass durch einen Bildlauf (programmgesteuert oder mithilfe der Schiebeleiste durchgeführt) eine Zelle mit Datenfehlern angezeigt wurde.This value indicates that a cell with data errors scrolled into view programmatically or with the scroll bar.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht.The following code example illustrates the use of this type. 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.This example is part of a larger example available in How to: Handle Errors That Occur During Data Entry in the Windows Forms DataGridView Control.

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 der bitweisen OR-Operation kombiniert werden, um den Zustand einer Datenbindung DataGridView darzustellen, wenn ein Datenfehler aufgetreten ist.Members of this enumeration may be combined using the bitwise OR operation to represent the state of a data-bound DataGridView when a data error occurred. Wenn ein Benutzer z. b. einen ungültigen Zellwert eingibt (z. b. einen Namen in eine Zelle, die ein Datum erwartet) und dann eine DataGridView andere Zelle auswählt, versucht, einen Commit für den ungültigen Zellwert auszuführen.For example, if a user enters an invalid cell value (such as entering a name in a cell that expects a date) and then selects a different cell, the DataGridView will try to commit the invalid cell value. Wenn der Commit fehlschlägt, DataGridView wird von ein DataError -Ereignis Context , dessen-Eigenschaft den Wert Commit und CurrentCellChange hat, zurückgibt.When the commit fails, the DataGridView will raise a DataError event whose Context property will have a value of Commit and CurrentCellChange.

Gilt für:

Siehe auch