Freigeben über


Übersicht über die ErrorProvider-Komponente (Windows Forms)

Die Windows Forms-Komponente ErrorProvider wird verwendet, um Benutzereingaben in einem Formular oder Steuerelement zu überprüfen. Sie wird normalerweise in Verbindung mit der Überprüfung von Benutzereingaben in ein Formular oder der Anzeige von Fehlern in einem Dataset verwendet. Ein Fehleranbieter ist eine bessere Alternative als die Anzeige einer Fehlermeldung in einem Meldungsfeld, denn sobald ein Meldungsfeld geschlossen wird, ist die Fehlermeldung nicht mehr sichtbar. Die ErrorProvider-Komponente zeigt ein Fehlersymbol (A white exclamation point inside a red circle.) neben dem betreffenden Steuerelement, z. B. einem Textfeld, an. Wenn der Benutzer den Mauszeiger über das Fehlersymbol bewegt, wird eine QuickInfo eingeblendet, die die Zeichenfolge mit der Fehlermeldung enthält.

Schlüsseleigenschaften

Die wichtigsten Eigenschaften der ErrorProvider-Komponente sind DataSource, ContainerControl, und Icon. Wenn Sie die ErrorProvider-Komponente mit datengebundenen Steuerelementen verwenden, muss die ContainerControl-Eigenschaft auf den entsprechenden Container (in der Regel das Windows-Formular) festgelegt werden, damit die Komponente ein Fehlersymbol auf dem Formular anzeigt. Wenn die Komponente im Designer hinzugefügt wird, wird die ContainerControl-Eigenschaft auf das enthaltende Formular festgelegt. Wenn Sie das Steuerelement im Code hinzufügen, müssen Sie es selbst festlegen.

Die Icon-Eigenschaft kann auf ein benutzerdefiniertes Fehlersymbol statt auf das Standardsymbol festgelegt werden. Wenn die DataSource-Eigenschaft festgelegt ist, kann die ErrorProvider-Komponente Fehlermeldungen für ein Dataset anzeigen. Die wichtigste Methode der ErrorProvider-Komponente ist die SetError-Methode, die die Zeichenfolge der Fehlermeldung und den Ort, an dem das Fehlersymbol angezeigt werden soll, angibt.

Hinweis

Die ErrorProvider-Komponente bietet keine integrierte Unterstützung für Clients mit Barrierefreiheit. Um Ihre Anwendung bei Verwendung dieser Komponente barrierefrei zu gestalten, müssen Sie einen zusätzlichen, barrierefreien Feedbackmechanismus bereitstellen.

Siehe auch