Tutorial: Erstellen einer Windows Forms-App mit .NET

In diesem Lernprogramm erfahren Sie, wie Sie Visual Studio zum Erstellen einer neuen Windows Forms-App verwenden. Mit Visual Studio fügen Sie einem Formular Steuerelemente hinzu und behandeln Ereignisse. Am Ende dieses Lernprogramms haben Sie eine einfache App, die einem Listenfeld Namen hinzufügt.

In diesem Tutorial:

• Erstellen einer neuen Windows Forms-Apps
• Hinzufügen von Steuerelementen zu einem Formular
• Verarbeiten von Steuerungsereignissen zum Bereitstellen von App-Funktionalität
• Ausführen der App

Voraussetzungen

• Visual Studio 2022, Version 17.12 oder höher
  • Wählen Sie die Workload .NET Desktop-Entwicklung aus
  • Auswählen der einzelnen .NET 9-Komponente

Erstellen einer Windows Forms-App

Für die Erstellung einer neuen App müssen Sie erst Visual Studio öffnen und die App dann aus einer Vorlage erstellen.

1. Öffnen Sie Visual Studio.

2. Wählen Sie Neues Projekt erstellen aus.

   

3. Geben Sie im Feld Nach Vorlagen suchen den Begriff winforms ein, und warten Sie, bis die Suchergebnisse angezeigt werden.

4. Wählen Sie aus der Dropdownliste Codesprache die Option C# oder Visual Basic aus.

5. Wählen Sie in der Liste der Vorlagen die Windows Forms-App und dann "Weiter" aus.

   Wichtig

   Wählen Sie nicht die Vorlage Windows Forms-App (.NET Framework) aus.

   Die folgende Abbildung zeigt Projektvorlagen für C# und Visual Basic .NET. Wenn Sie den Codesprachenfilter angewendet haben, wird die entsprechende Vorlage aufgelistet.

   

6. Legen Sie im Fenster "Neues Projekt konfigurieren" den Projektnamen auf "Namen" fest, und wählen Sie "Weiter" aus.

   Sie können Ihr Projekt auch in einem anderen Ordner speichern, indem Sie den Pfad für Speicherort anpassen.

   

7. Wählen Sie abschließend im Fenster "Zusätzliche Informationen" .NET 9.0 (Standard term Support) für die Framework-Einstellung aus, und wählen Sie dann "Erstellen" aus.

   

Nachdem die App generiert wurde, sollte Visual Studio das Designerfenster für das Standardformular "Form1" öffnen. Wenn der Formular-Designer nicht sichtbar ist, doppelklicken Sie im fenster Projektmappen-Explorer auf das Formular, um das Designerfenster zu öffnen.

Wichtige Visual Studio-Komponenten

Die Unterstützung für Windows Forms in Visual Studio verfügt über vier wichtige Komponenten, mit denen Sie interagieren, während Sie eine App erstellen:

1. Projektmappen-Explorer

   Alle Projektdateien, Code, Formulare, Ressourcen werden in diesem Fenster angezeigt.

2. Eigenschaften

   In diesem Fenster werden Eigenschafteneinstellungen angezeigt, die Sie basierend auf dem Kontext des ausgewählten Elements konfigurieren können. Wenn Sie beispielsweise ein Element aus Projektmappen-Explorer auswählen, werden Einstellungen für die Datei angezeigt. Wenn das Objekt im Designer ausgewählt ist, werden die Eigenschaften des Steuerelements oder Formulars angezeigt.

3. Formular-Designer

   Dies ist der Designer für das Formular. Hierbei handelt es sich um eine interaktive Oberfläche, in die Sie Objekte per Drag & Drop aus der Toolbox verschieben können. Wenn Sie Elemente im Designer auswählen und verschieben, können Sie die Benutzeroberfläche für Ihre App visuell zusammenstellen.

4. Werkzeugkasten

   Die Toolbox enthält alle Steuerelemente, die Sie einem Formular hinzufügen können. Doppelklicken Sie zum Hinzufügen eines Steuerelements zum aktuellen Formular auf ein Steuerelement, oder verschieben Sie das Steuerelement per Drag & Drop.

Tipp

Wenn die Toolbox nicht sichtbar ist, können Sie sie über das Menüelement Ansicht>Toolbox anzeigen.

Hinzufügen von Steuerelementen zu dem Formular

Verwenden Sie beim Öffnen des Formular1-Formular-Designers das Toolboxfenster , um dem Formular die folgenden Steuerelemente hinzuzufügen, indem Sie sie aus der Toolbox ziehen und im Formular ablegen:

• Taste
• Label
• Listenfeld
• Textfeld

Positionieren und größen Sie die Steuerelemente entsprechend der folgenden Abbildung:

Sie können die Steuerelemente entweder mit der Maus verschieben und deren Größe an das vorherige Bild anpassen oder die folgende Tabelle verwenden, um jedes Steuerelement zu konfigurieren. Um ein Steuerelement zu konfigurieren, wählen Sie es im Designer aus, und legen Sie dann die entsprechende Einstellung im Eigenschaftenfenster fest. Wählen Sie beim Konfigurieren des Formulars die Titelleiste des Formulars aus.

Objekt	Einstellung	Wert
Bezeichnung	Standort	12, 9
	Text	Names
Listenfeld	Name	lstNames
	Standort	12, 27
	Größe	120, 94
Textfeld	Name	txtName
	Standort	138, 26
	Größe	100, 23
Schaltfläche	Name	btnAdd
	Standort	138, 55
	Größe	100, 23
	Text	Add Name
Form	Text	Names
	Größe	268, 180

Behandeln von Ereignissen

Nachdem das Formular nun alle steuerelemente angeordnet hat, besteht der nächste Schritt darin, Ereignishandler hinzuzufügen, um auf Benutzereingaben zu reagieren. Wechseln Sie zum Formular-Designer, und führen Sie die folgenden Schritte aus:

1. Wählen Sie im Formular das Schaltflächensteuerelement "Namen hinzufügen" aus.

2. Wählen Sie im Eigenschaftenfenster das Ereignissymbol aus, um die Ereignisse der Schaltfläche auflisten zu können.

3. Suchen Sie nach dem Click-Ereignis, und doppelklicken Sie darauf, um einen Ereignishandler zu erzeugen.

   Diese Aktion fügt dem Formular den folgenden Code hinzu:

   private void btnAdd_Click(object sender, EventArgs e)
   {
   
   }
   

   Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
   
   End Sub
   

   Der Code für diesen Handler wird den durch das txtName Textfeld angegebenen Namen zum lstNames Listenfeld hinzufügen. Für das Hinzufügen des Namens sollen jedoch zwei Bedingungen gelten: der angegebene Name darf nicht leer sein, und der Name darf noch nicht vorhanden sein.

4. Im folgenden Code wird veranschaulicht, wie dem lstNames-Steuerelement ein Name hinzugefügt wird:

   private void btnAdd_Click(object sender, EventArgs e)
   {
       if (!string.IsNullOrWhiteSpace(txtName.Text) && !lstNames.Items.Contains(txtName.Text))
           lstNames.Items.Add(txtName.Text);
   }
   

   Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
       If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then
           lstNames.Items.Add(txtName.Text)
       End If
   End Sub
   

Ausführen der App

Nachdem das Ereignis behandelt wird, führen Sie die App aus, indem Sie F5 drücken oder im Menü "Debuggen>starten" auswählen. Wenn die App gestartet wird, wird das Formular angezeigt, und Sie können einen Namen in das Textfeld eingeben und die Schaltfläche auswählen.

Zugehöriger Inhalt

• Weitere Informationen zu Windows Forms
• Übersicht über die Verwendung von Steuerelementen
• Übersicht über Ereignisse