DataGridViewDataErrorContexts Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje stav ovládacího prvku vázaného DataGridView na data, když došlo k chybě dat.
Tento výčet podporuje bitové kombinace hodnot jeho členů.
public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
[<System.Flags>]
type DataGridViewDataErrorContexts =
Public Enum DataGridViewDataErrorContexts
- Dědičnost
- Atributy
Pole
ClipboardContent | 16384 | Při kopírování obsahu do schránky došlo k chybě dat. Tato hodnota označuje, že hodnotu buňky nebylo možné převést na řetězec. |
Commit | 512 | Při potvrzení změn v úložišti dat došlo k chybě dat. Tato hodnota označuje, že data zadaná v buňce nelze potvrdit do příslušného úložiště dat. |
CurrentCellChange | 4096 | Při přesunutí kurzoru výběru do jiné buňky došlo k chybě dat. Tato hodnota označuje, že uživatel vybral buňku, když dříve vybraná buňka měla chybovou podmínku. |
Display | 2 | Při zobrazení buňky naplněné zdrojem dat došlo k chybě dat. Tato hodnota označuje, že hodnotu ze zdroje dat nelze v buňce zobrazit, nebo chybí mapování, které hodnotu ze zdroje dat překládá do buňky. |
Formatting | 1 | Při pokusu o formátování dat, která se odesílají do úložiště dat nebo načítají z úložiště dat, došlo k chybě dat. Tato hodnota označuje, že se nepodařilo správně naformátovat změnu buňky. Buď je potřeba opravit novou hodnotu buňky, nebo změnit její formátování. |
InitialValueRestoration | 1024 | Při obnovení předchozí hodnoty buňky došlo k chybě dat. Tato hodnota označuje, že se buňka pokusila zrušit úpravy a vrácení zpět na počáteční hodnotu se nezdařilo. K tomu může dojít, pokud se formátování buňky změnilo tak, aby nebylo kompatibilní s počáteční hodnotou. |
LeaveControl | 2048 | Při ztrátě fokusu DataGridView došlo k chybě dat. Tato hodnota označuje, že uživatel DataGridView nemohl potvrdit změny uživatele po ztrátě fokusu. |
Parsing | 256 | Při analýze nových dat došlo k chybě dat. Tato hodnota označuje, že DataGridView objekt nemohl analyzovat nová data, která byla zadána uživatelem nebo načtena z podkladového úložiště dat. |
PreferredSize | 4 | Při výpočtu upřednostňované velikosti buňky došlo k chybě dat. Tato hodnota označuje, že se DataGridView při programové změně velikosti sloupce nebo řádku nepodařilo vypočítat upřednostňovanou šířku nebo výšku buňky. K tomu může dojít v případě, že se buňce nepodaří naformátovat svoji hodnotu. |
RowDeletion | 8 | Při odstraňování řádku došlo k chybě dat. Tato hodnota označuje, že podkladové úložiště dat vyvolalo výjimku při odstranění řádku vázaného DataGridView na data. |
Scroll | 8192 | Při posouvání nové oblasti do zobrazení došlo k chybě dat. Tato hodnota označuje, že se buňka s chybami dat posouvají do zobrazení programově nebo pomocí posuvníku. |
Příklady
Následující příklad kódu ukazuje použití tohoto typu. Tento příklad je součástí většího příkladu dostupného v části Postupy: Zpracování chyb, ke kterým dochází při zadávání dat v ovládacím prvku model Windows Forms 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
Poznámky
Členy tohoto výčtu lze kombinovat pomocí bitové operace OR k reprezentaci stavu datové vazby DataGridView , když došlo k chybě dat. Pokud například uživatel zadá neplatnou hodnotu buňky (například zadá název do buňky, která očekává datum) a pak vybere jinou buňku DataGridView , pokusí se potvrdit neplatnou hodnotu buňky. Když potvrzení selže, vyvolá DataError událost, DataGridView jejíž Context vlastnost bude mít hodnotu Commit a CurrentCellChange.