Freigeben über


ErrorProvider-Komponentenübersicht (Windows Forms)

Die Komponente "Windows Forms ErrorProvider" wird verwendet, um benutzereingaben in einem Formular oder Steuerelement zu überprüfen. Sie wird in der Regel in Verbindung mit der Überprüfung von Benutzereingaben in einem Formular oder beim Anzeigen von Fehlern innerhalb eines Datasets verwendet. Ein Error-Provider ist eine bessere Alternative als das Anzeigen einer Fehlermeldung in einem Dialogfeld, da nach dem Schließen eines Dialogfelds die Fehlermeldung nicht mehr sichtbar ist. Die ErrorProvider-Komponente zeigt ein Fehlersymbol (Weißes Ausrufezeichen in einem roten Kreis) neben dem relevanten Steuerelement an (z. B. einem Textfeld). Wenn die Benutzenden den Mauszeiger auf dem Fehlersymbol positionieren, wird eine QuickInfo mit der Fehlermeldungszeichenfolge angezeigt.

Schlüsseleigenschaften

Die wichtigsten Eigenschaften der ErrorProvider Komponente sind DataSource, ContainerControlund Icon. Bei der Verwendung der ErrorProvider-Komponente mit datengebundenen Steuerelementen muss die ContainerControl-Eigenschaft auf den entsprechenden Container (in der Regel das Windows-Formular) festgelegt werden, damit die Komponente ein Fehlersymbol im Formular anzeigen kann. 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 eigenschaft Icon kann anstelle des Standardwerts auf ein benutzerdefiniertes Fehlersymbol festgelegt werden. Wenn die DataSource-Eigenschaft festgelegt ist, kann die ErrorProvider Komponente Fehlermeldungen für ein Dataset anzeigen. Die Schlüsselmethode der ErrorProvider-Komponente ist die SetError Methode, die die Fehlermeldungszeichenfolge angibt und wo das Fehlersymbol angezeigt werden soll.

Anmerkung

Die ErrorProvider-Komponente bietet keine integrierte Unterstützung für Barrierefreiheitsclients. Damit Ihre Anwendung bei Verwendung dieser Komponente barrierefrei ist, müssen Sie einen zusätzlichen, barrierefreien Feedbackmechanismus bereitstellen.

Siehe auch