Freigeben über


Gewusst wie: Hinzufügen einer parametrisierten Abfrage zu einem Formular in einer Windows Forms-Anwendung

Einem Formular in einer Windows-Anwendung kann durch das Ausführen einer parametrisierten Abfrage Suchfunktionalität hinzugefügt werden. Eine parametrisierte Abfrage gibt Daten zurück, die den Bedingungen einer WHERE-Klausel entsprechen. Sie parametrisieren eine Abfrage, indem Sie das Dialogfeld "Suchkriterien-Generator" ausfüllen. Sie können beispielsweise eine Abfrage so parametrisieren, dass lediglich die Kunden aus einer bestimmten Stadt angezeigt werden, indem Sie am Ende der SQL-Anweisung, die eine Liste mit Kunden zurückgibt, WHERE City = @City hinzufügen. Weitere Informationen finden Sie unter Parameterabfragen.

Wenn Sie das Dialogfeld Suchkriterien ausfüllen, geschieht Folgendes:

  • Die Abfrage wird dem zugeordneten TableAdapter hinzugefügt.

  • Dem Formular werden Steuerelemente hinzugefügt, damit die Benutzer die erforderlichen Parameterwerte eingeben können. Außerdem wird eine Schaltfläche zum Ausführen der Abfrage hinzugefügt.

  • Dem Click-Ereignis der Schaltfläche wird Code zum Festlegen der Parameterwerte und zum Ausführen der Abfrage hinzugefügt.

Tipp

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.

So fügen Sie eine Abfrage einem vorhandenen datengebundenen Formular hinzu

  1. Öffnen Sie das Formular im Windows Forms-Designer.

  2. Klicken Sie im Menü Daten oder in den Smarttags für Daten auf Abfrage hinzufügen.

    Tipp

    Falls der Befehl Abfrage hinzufügen im Menü Daten nicht verfügbar ist, markieren Sie im Formular ein Steuerelement, das die Datenquelle anzeigt, der Sie die Parametrisierung hinzufügen möchten. Wenn im Formular z. B. in einem DataGridView-Steuerelement Daten angezeigt werden, wählen Sie dieses aus. Werden die Daten im Formular in einzelnen Steuerelementen angezeigt, wählen Sie eines der datengebundenen Steuerelemente aus.

  3. Wählen Sie im Bereich Tabelle in Datenquelle auswählen die gewünschte Tabelle aus, der die Parametrisierung hinzugefügt werden soll. Weitere Informationen finden Sie unter Dialogfeld "Suchkriterien-Generator".

  4. Geben Sie im Feld Neuer Abfragename einen Namen an, wenn Sie eine neue Abfrage erstellen.

    - oder -

    Wählen Sie im Feld Vorhandener Abfragename eine Abfrage aus.

  5. Geben Sie im Feld Abfragetext eine Abfrage ein, die Parameter akzeptiert.

    Tipp

    Verwenden Sie den Abfrage-Generator, der Sie beim Erstellen der Abfrage unterstützt. Weitere Informationen finden Sie unter Tools im Abfrage- und Ansicht-Designer.

  6. Klicken Sie auf OK.

    Dem Formular in einem ToolStrip-Steuerelement werden ein Steuerelement zur Eingabe des Parameters und die Schaltfläche Laden hinzugefügt.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen eines Windows Forms zum Suchen von Daten

Exemplarische Vorgehensweise: Anzeigen von Daten in einem Windows Form

Gewusst wie: Herstellen einer Verbindung zu Daten in einer Datenbank

Gewusst wie: Datennavigation mithilfe des DataNavigator-Steuerelements in Windows Forms

Gewusst wie: Sortieren und Filtern von ADO.NET-Daten mit der BindingSource-Komponente in Windows Forms

Gewusst wie: Erstellen einer Suchtabelle mit der BindingSource-Komponente in Windows Forms

Referenz

Datenquellenfenster

Konzepte

Übersicht über TableAdapters

DataSet-Designer

Übersicht über Datenquellen

Weitere Ressourcen

Überprüfen von Daten