Gewusst wie: Erstellen einer C#-Windows Forms-Anwendung

Artikel
09/02/2008

Aktualisiert: November 2007

In diesem Thema werden die Elemente der integrierten Entwicklungsumgebung (IDE) von Visual C# Express Edition beim Erstellen von relativ einfachen C#-Programmen mit Windows Forms erläutert. Windows Forms stellt für das Projekt die Komponenten bereit, die die Benutzeroberfläche einer Windows-Standardanwendung bilden, z. B. Dialogfelder, Menüs, Schaltflächen und viele weitere Steuerelemente. Im Wesentlichen handelt es sich bei diesen Steuerelementen um Klassen der .NET Framework-Klassenbibliothek. Sie ziehen die Steuerelemente mithilfe der Entwurfsansichtin Visual C# Express Edition in das Hauptformular der Anwendung und passen die Größe und die Position an. Dabei fügt die IDE automatisch den Quellcode hinzu, mit dem eine Instanz der entsprechenden Klasse erstellt und initialisiert wird.

Dieses Beispiel veranschaulicht, wie eine eigene Webbrowseranwendung erstellt wird, die Sie mit Verknüpfungen zu Ihren bevorzugten Websites anpassen können.

In diesem Abschnitt erfahren Sie, wie Sie die folgenden Aufgaben ausführen:

Erstellen Sie eine neue Windows Forms-Anwendung.
Wechseln Sie zwischen der Codeansicht und der Entwurfsansicht.
Ändern Sie die Windows Form-Eigenschaften.
Fügen Sie ein MenuStrip-Steuerelement hinzu.
Fügen Sie ein Button-Steuerelement hinzu.
Erstellen Sie ein ComboBox-Steuerelement, und füllen Sie es.
Verwenden Sie ein WebBrowser-Steuerelement.
Erstellen Sie Ereignishandler für Steuerelemente.

Unter Video How to: Create a C# Windows Forms Application finden Sie eine Videodemonstration.

So erstellen Sie eine C#-Windows-Anwendung

Klicken Sie im Menü Datei auf Neues Projekt.

Das Dialogfeld Neues Projekt wird angezeigt. Darin sind die verschiedenen Standardanwendungstypen aufgelistet, die mit Visual C# Express Edition erstellt werden können.
Wählen Sie als Projekttyp Windows Forms-Anwendung aus.
Ändern Sie den Namen der Anwendung in Web Browser.
Klicken Sie auf OK.

Visual C# Express Edition erstellt einen neuen Ordner für das nach dem Projekttitel benannte Projekt und zeigt dann das neue Windows Form mit dem Namen Form1 in der Entwurfsansicht an. Sie können jederzeit zwischen dieser Ansicht und der Codeansicht wechseln. Klicken Sie dazu mit der rechten Maustaste auf die Entwurfsoberfläche oder das Codefenster, und wählen Sie Code anzeigen bzw. Ansicht-Designer aus.

Bei dem in der Entwurfsansicht angezeigten Windows Form handelt es sich um eine visuelle Darstellung des Fensters, das beim Starten der Anwendung geöffnet wird. In der Entwurfsansicht können Sie verschiedene Steuerelemente aus der Toolbox auf das Formular ziehen. Diese Steuerelemente sind nicht verwendbar. Es handelt sich lediglich um Abbildungen, die im Formular bequem und präzise positioniert werden können.

Nachdem Sie ein Steuerelement im Formular abgelegt haben, erstellt Visual C# im Hintergrund den Code, mit dem das echte Steuerelement beim Ausführen des Programms richtig positioniert wird. Dieser Quellcode ist in einer Datei enthalten, die in der Regel ausgeblendet geschachtelt wird. Sie können diese Datei mit dem Namen Form1.designer.cs im Projektmappen-Explorer anzeigen, wenn Sie Form1.cs erweitern.
Wenn Sie in der Codeansicht sind, wechseln Sie in die Entwurfsansicht, indem Sie mit der rechten Maustaste in das Codefenster klicken und Ansicht-Designer auswählen. Ändern Sie dann die Größe des Windows Form.
1. Klicken Sie auf die rechte untere Ecke im Windows Form.
2. Wenn sich der Mauszeiger in einen Doppelpfeil verwandelt, ziehen Sie an der Ecke des Formulars, bis es etwa ungefähr so groß wie ein Viertel des Bildschirms ist.
  
  In diesem Fenster werden Webseiten angezeigt, es sollte daher nicht zu klein sein.
Vergewissern Sie sich, dass das Eigenschaftenfenster angezeigt wird. Seine Standardposition ist im unteren rechten Bereich der IDE. Es kann jedoch an eine beliebige andere Position verschoben werden. In der folgenden Abbildung wird es in der oberen rechten Ecke angezeigt. Wenn Sie das Fenster Eigenschaften nicht sehen, klicken Sie im Menü Ansicht auf Eigenschaftenfenster. In diesem Fenster werden die Eigenschaften des gerade ausgewählten Windows Forms oder Steuerelements angezeigt. Außerdem können hier die vorhandenen Werte geändert werden.
Ändern Sie den Titel des Windows Form.
1. Klicken Sie auf das Formular, um es auszuwählen.
2. Führen Sie im Eigenschaftenfenster einen Bildlauf zu Text durch, wählen Sie den Text "Form1" aus, und geben Sie Web Browser ein.
3. Drücken Sie die EINGABETASTE oder die TAB-TASTE, um den Fokus vom Textfeld "Text" zu entfernen.
Jetzt können Sie sehen, dass sich der Text am oberen Rand des Windows Forms (im Bereich der Titelleiste) geändert hat.

Um den Namen eines Steuerelements schnell zu ändern, klicken Sie mit der rechten Maustaste auf das Steuerelement und dann auf Eigenschaften. Sie können den neuen Namen für das Steuerelement in der Eigenschaft Name eingeben.
Klicken Sie auf der Symbolleiste auf die Schaltfläche Toolbox oder im Menü Ansicht auf die Option Toolbox. Führen Sie in der Liste der Steuerelemente einen Bildlauf durch, und erweitern Sie Menüs und Symbolleisten, bis Sie MenuStrip gefunden haben. Ziehen Sie dieses Steuerelement in das Windows Form.

Das Steuerelement erstellt am oberen Rand des Formulars ein Standardmenü.
Geben Sie im Feld Hier eingeben den Namen des Menüs ein, in diesem Fall den Namen Navigate. Durch Drücken der EINGABETASTE werden neue leere Felder zum Erstellen weiterer Menüs und Menüelemente angezeigt. Geben Sie im unteren Feld den Text Home ein. Drücken Sie die EINGABETASTE. Daraufhin werden weitere Felder angezeigt. Geben Sie den Text Go Back ein. Drücken Sie die EINGABETASTE, und geben Sie den Text Go Forward ein.

Diese Menüelemente bilden die grundlegenden Websitenavigationssteuerelemente.
Hinzufügen einer Schaltfläche.

Ziehen Sie aus der Toolbox in der Kategorie Allgemeine Steuerelemente ein Button-Steuerelement ungefähr in die Mitte des Windows Form, unmittelbar unter die Menüleiste. Geben Sie im Fenster Eigenschaften für die Text-Eigenschaft den Text Go anstatt button1 ein, und ändern Sie den Entwurfnamen, der aussieht wie (Name), von button1 in goButton.

Hinzufügen eines Kombinationsfelds.

Ziehen Sie ein ComboBox-Steuerelement aus der Toolbox in der Kategorie Allgemeine Steuerelemente, und positionieren Sie es links von der neuen Schaltfläche. Ziehen Sie die Rahmen und Ecken, um die Größe und die Position des Kombinationsfelds so anzupassen, dass es sich auf einer Linie mit der Schaltfläche befindet.

Hinweis:
Wenn Sie Steuerelemente in einem Windows Form verschieben, werden blaue Linien eingeblendet. Diese Linien unterstützen Sie beim vertikalen und horizontalen Ausrichten der Steuerelemente. Sie können auch mehrere Steuerelemente gleichzeitig ausrichten, indem Sie diese zusammen auswählen. Klicken Sie dazu auf ein Auswahlfeld, und ziehen Sie es um die Steuerelemente, oder halten Sie beim Klicken auf die Steuerelemente die UMSCHALTTASTE gedrückt. Nachdem Sie mehrere Steuerelemente ausgewählt haben, können Sie die Ausrichtung und Größe mit den Symbolen zum Ausrichten und Ändern der Größe anpassen. Diese Symbole werden auf der Layoutsymbolleiste am oberen Rand des Fensters Entwurf angezeigt.

Wenn Sie Steuerelemente in einem Windows Form verschieben, werden blaue Linien eingeblendet. Diese Linien unterstützen Sie beim vertikalen und horizontalen Ausrichten der Steuerelemente. Sie können auch mehrere Steuerelemente gleichzeitig ausrichten, indem Sie diese zusammen auswählen. Klicken Sie dazu auf ein Auswahlfeld, und ziehen Sie es um die Steuerelemente, oder halten Sie beim Klicken auf die Steuerelemente die UMSCHALTTASTE gedrückt. Nachdem Sie mehrere Steuerelemente ausgewählt haben, können Sie die Ausrichtung und Größe mit den Symbolen zum Ausrichten und Ändern der Größe anpassen. Diese Symbole werden auf der Layoutsymbolleiste am oberen Rand des Fensters Entwurf angezeigt.

Füllen Sie die ComboBox auf.

Eine ComboBox stellt eine Dropdownliste mit Optionen bereit, aus der Benutzer auswählen können. In diesem Programm enthält die ComboBox eine Liste Ihrer bevorzugten Websites für den Schnellzugriff.

Wählen Sie zum Erstellen der Liste die ComboBox aus, und zeigen Sie ihre Eigenschaften an. Wählen Sie die Eigenschaft Elemente aus. Daraufhin sehen Sie das Wort (Auflistung) und eine Schaltfläche mit Auslassungszeichen (…). Klicken Sie auf diese Schaltfläche, um den Inhalt der ComboBox zu ändern. Fügen Sie die gewünschten Website-URLs hinzu, indem Sie nach jeder Auswahl die EINGABETASTE drücken.

Hinweis:

Fügen Sie vor jeder Websiteadresse http:// ein.
Fügen Sie das WebBrowser-Steuerelement hinzu.

Führen Sie in der Toolbox in der Kategorie Allgemeine Steuerelemente einen Bildlauf durch, bis Sie das WebBrowser-Steuerelement gefunden haben. Ziehen Sie das Steuerelement in das Windows Form. Ändern Sie die Größe des WebBrowser-Steuerelements, sodass es sich in das Windows Form einfügt, ohne dass das ComboBox-Steuerelement und das Button-Steuerelement verdeckt werden. Wenn sich die Größe des WebBrowser-Steuerelements nicht problemlos ändern lässt, legen Sie zunächst die gewünschte Größe fest, öffnen Sie die Eigenschaften, suchen Sie die Dock-Einstellung, und legen Sie sie gegebenenfalls auf keine fest. Wenn Sie die Anchor-Einstellungen auf Oben, Unten, Links, Rechts festlegen, wird die Größe des WebBrowser-Steuerelements beim Ändern der Größe des Anwendungsfensters ordnungsgemäß angepasst.

Das WebBrowser-Steuerelement führt die aufwändige Arbeit der Darstellung der Webseiten aus. Innerhalb der Anwendung können Sie auf das Steuerelement über eine Instanz der WebBrowser-Klasse zugreifen. In der Datei form1.Designer.cs können Sie sehen, dass dem Anwendungscode neben Instanzen der Klassen, die die weiteren mit dem Designer hinzugefügten Elemente darstellen, eine Instanz dieser Klasse hinzugefügt wurde. Diese Instanzen verwenden Sie auch beim Hinzufügen von Ereignishandlern für Steuerelemente und von aufgerufenen Methoden in den Steuerelementen.
Fügen Sie einen Ereignishandler für das Button-Steuerelement hinzu.

Die Entwurfsphase der Anwendung ist jetzt abgeschlossen, und Sie müssen mit dem Hinzufügen von Code beginnen, um die Funktonalität des Programms bereitzustellen.

Das Programm muss über Ereignishandler für die Schaltfläche und jede Menüoption verfügen. Ein Ereignishandler ist eine Methode, die beim Interagieren des Benutzers mit dem Steuerelement ausgeführt wird. Visual C# Express Edition erstellt automatisch leere Ereignishandler.

Doppelklicken Sie auf die Schaltfläche. Der Code-Editor für das Projekt wird angezeigt. Außerdem können Sie sehen, dass der Ereignishandler für das Click-Ereignis – die Ereignismeldung, die beim Klicken des Benutzers auf eine Schaltfläche auftritt – erstellt wurde. Fügen Sie der Ereignishandlermethode etwa folgenden Code hinzu.
```
private void goButton_Click(object sender, System.EventArgs e)
{
    webBrowser1.Navigate(new Uri(comboBox1.SelectedItem.ToString()));
}
```
Dieser Code übergibt das gerade ausgewählte Element aus dem ComboBox-Steuerelement, eine Zeichenfolge, die eine Web-URL enthält, an die Navigate-Methode des Webbrowsers. Die Navigate-Methode lädt den Inhalt der Webseite und zeigt ihn an dieser Position an.

Hinweis:
Fügen Sie vor jeder Websiteadresse http:// ein.

Fügen Sie Ereignishandler für die MenuStrip-Optionen hinzu.

Kehren Sie zum Entwurfsfenster zurück, und doppelklicken Sie der Reihe nach auf die einzelnen Untermenübefehle. Visual C# Express Edition erstellt Ereignishandlermethoden für alle Elemente. Bearbeiten Sie diese Methoden, sodass sie etwa wie der folgende Code aussehen.

private void homeToolStripMenuItem_Click(object sender, System.EventArgs e)
{
    webBrowser1.GoHome();
}

private void goForwardToolStripMenuItem_Click(object sender, System.EventArgs e)
{
    webBrowser1.GoForward();
}

private void goBackToolStripMenuItem_Click(object sender, System.EventArgs e)
{
    webBrowser1.GoBack();
}

Jeder dieser Menühandler ruft eine Navigationsmethode auf, die in der WebBrowser-Klasse unterstützt wird.

Hinweis:
Am Code sehen Sie, dass die Standardnamen der Menüoptionen ziemlich verwirrend werden können. Aus diesem Grund empfiehlt es sich, den Namen der Menüsteuerelemente bereits beim Erstellen dieser Steuerelemente im Eigenschaften-Editor zu ändern. Der Name des Handlers gibt dann den Namen der Menüoption wieder.

Ansehen des Codes, den Visual C# geschrieben hat.

Die Visual C#-IDE hat bereits Initialisierungscode für Sie geschrieben. Suchen Sie in der Codeansicht den Konstruktor für die Form1-Klasse. Die Signatur lautet public Form1(). Klicken Sie mit der rechten Maustaste auf die InitializeComponent-Methode, die vom Konstruktor aufgerufen wird, und wählen Sie Gehe zu Definition. Jetzt können Sie den gesamten Code sehen, der im Hintergrund geschrieben wurde, während Sie per Drag & Drop Steuerelemente verschoben und im Fenster Eigenschaften Eigenschaften festgelegt haben.
Hinzufügen von eigenem Initialisierungscode.

Die letzte Aufgabe besteht darin, Form1 eigenen Initialisierungscode hinzuzufügen. Verwenden Sie den Konstruktor niemals zum Aufrufen von Code, der eine Ausnahme auslösen könnte. Deshalb muss sich Code dieser Art stets an einer anderen Stelle befinden, und zwar in der Form1_Load-Methode. Klicken Sie oben im Code-Editor auf die Registerkarte Form1.cs[Design], um zum Windows Form zurückzukehren. Wählen Sie das Formular aus, klicken Sie im Fenster Eigenschaften auf die Schaltfläche Ereignisse (mit dem Blitzsymbol), und doppelklicken Sie dann auf Laden. Dadurch wird eine Ereignishandlermethode hinzugefügt, und der Cursor wird in der Methode in der Codeansicht positioniert.

Wenn ein Benutzer das Programm startet, wird das Formular der Anwendung von Windows durch das Senden eines Load-Ereignisses benachrichtigt. Wenn das Formular dieses Ereignis empfängt, wird die Form1_Load-Methode aufgerufen. Methoden, die als Reaktion auf Ereignisse aufgerufen werden, werden als Ereignishandler bezeichnet. Das System ruft das Ereignis zum richtigen Zeitpunkt auf. Ihre Aufgabe besteht darin, den Code in den Ereignishandler einzufügen, der beim Auftreten des Ereignisses ausgeführt werden soll.

Fügen Sie in der Codeansicht der Form1_Load-Methode die im folgenden Code gezeigten zwei Zeilen hinzu. Dadurch zeigt das WebBrowser-Steuerelement die Standardhomepage des Computers an und legt den Anfangswert der ComboBox fest.
```
private void Form1_Load(object sender, EventArgs e)
{
    comboBox1.SelectedIndex = 0;
    webBrowser1.GoHome();
}
```
Erstellen und Ausführen des Programms.

Drücken Sie F5, um den Webbrowser auszuführen. Das Windows Form wird auf dem Bildschirm angezeigt und ruft dann die Standardhomepage des Computers auf. Wählen Sie mithilfe des ComboBox-Steuerelements eine Website aus, und klicken Sie auf Gehe zu, um dorthin zu navigieren. Mithilfe der Menüoptionen können Sie zur Homepage zurückkehren oder zwischen zuvor besuchten Websites hin- und herwechseln.

Wenn Sie in der C#-Programmierung noch unerfahren sind, sollten Sie jetzt den Abschnitt Einführung in C# lesen. Weitere Informationen zur Visual C# Express Edition-Entwicklungsumgebung und zum Erstellen von Konsolenanwendungen unter spezieller Verwendung von IntelliSense finden Sie unter Gewusst wie: Erstellen einer C#-Konsolenanwendung. . Informationen zur Erstellung von Windows Presentation Foundation-Anwendungen finden Sie unter Gewusst wie: Erstellen einer WPF-Anwendung in C#.

Siehe auch

Gewusst wie: Erstellen einer C#-Windows Forms-Anwendung

So erstellen Sie eine C#-Windows-Anwendung

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen