Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Application-Klasse

Stellt static-Methoden und Eigenschaften für die Verwaltung einer Anwendung zur Verfügung, z. B. Methoden zum Starten und Beenden einer Anwendung, zum Verarbeiten von Windows-Meldungen sowie Eigenschaften für das Abrufen von Informationen zu einer Anwendung. Diese Klasse kann nicht vererbt werden.

System.Object
  System.Windows.Forms.Application

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public sealed class Application

Der Application-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Eigenschaft Statischer Member AllowQuit Ruft einen Wert ab, der angibt, ob der Aufrufer diese Anwendung beenden kann.
Öffentliche Eigenschaft Statischer Member CommonAppDataPath Ruft den Pfad für die Anwendungsdaten ab, die von allen Benutzern gemeinsam genutzt werden.
Öffentliche Eigenschaft Statischer Member CommonAppDataRegistry Ruft den Registrierungsschlüssel für die Anwendungsdaten ab, die von allen Benutzern gemeinsam genutzt werden.
Öffentliche Eigenschaft Statischer Member CompanyName Ruft den der Anwendung zugeordneten Firmennamen ab.
Öffentliche Eigenschaft Statischer Member CurrentCulture Ruft die Kulturinformationen für den aktuellen Thread ab oder legt diese fest.
Öffentliche Eigenschaft Statischer Member CurrentInputLanguage Ruft die aktuelle Eingabesprache für den aktuellen Thread ab oder legt diese fest.
Öffentliche Eigenschaft Statischer Member ExecutablePath Ruft den Pfad einschließlich des Namens der ausführbaren Datei ab, die zum Starten der Anwendung verwendet wurde.
Öffentliche Eigenschaft Statischer Member LocalUserAppDataPath Ruft den Pfad für die Anwendungsdaten eines lokalen Benutzers ab, der kein Roaming verwendet.
Öffentliche Eigenschaft Statischer Member MessageLoop Ruft einen Wert ab, der angibt, ob für diesen Thread eine Nachrichtenschleife vorhanden ist.
Öffentliche Eigenschaft Statischer Member OpenForms Ruft eine Auflistung offener Formulare ab, die sich im Besitz der Anwendung befinden.
Öffentliche Eigenschaft Statischer Member ProductName Ruft den dieser Anwendung zugeordneten Produktnamen ab.
Öffentliche Eigenschaft Statischer Member ProductVersion Ruft die dieser Anwendung zugeordnete Produktversion ab.
Öffentliche Eigenschaft Statischer Member RenderWithVisualStyles Ruft einen Wert ab, der angibt, ob die aktuelle Anwendung Steuerelemente mit visuellen Stilen zeichnet.
Öffentliche Eigenschaft Statischer Member SafeTopLevelCaptionFormat Ruft die Formatzeichenfolge ab, die den Beschriftungen der Fenster auf oberster Ebene zugewiesen wird, wenn diese mit einem Warnbanner angezeigt werden, oder legt diese fest.
Öffentliche Eigenschaft Statischer Member StartupPath Ruft den Pfad ohne den Namen der ausführbaren Datei ab, die zum Starten der Anwendung verwendet wurde.
Öffentliche Eigenschaft Statischer Member UserAppDataPath Ruft den Pfad für die Anwendungsdaten eines Benutzers ab.
Öffentliche Eigenschaft Statischer Member UserAppDataRegistry Ruft den Registrierungsschlüssel für die Anwendungsdaten eines Benutzers ab.
Öffentliche Eigenschaft Statischer Member UseWaitCursor Ruft ab oder legt fest, ob der Wartecursor für alle offenen Formulare der Anwendung verwendet wird.
Öffentliche Eigenschaft Statischer Member VisualStyleState Ruft einen Wert ab, der angibt, wie visuelle Stile für Anwendungsfenster übernommen werden.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Statischer Member AddMessageFilter Fügt einen Meldungsfilter zum Überwachen von Windows-Meldungen beim Weiterleiten an das Ziel hinzu.
Öffentliche Methode Statischer Member DoEvents Verarbeitet alle Windows-Meldungen, die sich derzeit in der Meldungswarteschlange befinden.
Öffentliche Methode Statischer Member EnableVisualStyles Aktiviert visuelle Stile für die Anwendung.
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Öffentliche Methode Statischer Member Exit() Weist alle Nachrichtensysteme an, die Verarbeitung zu beenden, und schließt alle Anwendungsfenster, sobald die Meldungen verarbeitet wurden.
Öffentliche Methode Statischer Member Exit(CancelEventArgs) Weist alle Nachrichtensysteme an, die Verarbeitung zu beenden, und schließt alle Anwendungsfenster, sobald die Meldungen verarbeitet wurden.
Öffentliche Methode Statischer Member ExitThread Verlässt die Nachrichtenschleife für den aktuellen Thread und schließt alle Fenster des Threads.
Öffentliche Methode Statischer Member FilterMessage Führt etwaige Filter für eine Fenstermeldung aus und gibt eine Kopie der geänderten Meldung zurück.
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Statischer Member OleRequired Initialisiert OLE für den aktuellen Thread.
Öffentliche Methode Statischer Member OnThreadException Löst das ThreadException-Ereignis aus.
Öffentliche Methode Statischer Member RaiseIdle Löst das Idle-Ereignis in gehosteten Szenarien aus.
Öffentliche Methode Statischer Member RegisterMessageLoop Registriert einen Rückruf für die Prüfung, ob die Nachrichtenschleife in gehosteten Umgebungen ausgeführt wird.
Öffentliche Methode Statischer Member RemoveMessageFilter Entfernt einen Meldungsfilter aus dem Nachrichtensystem der Anwendung.
Öffentliche Methode Statischer Member Restart Schließt die Anwendung und startet sofort eine neue Instanz.
Öffentliche Methode Statischer Member Run() Beginnt die Ausführung einer Standardmeldungsschleife einer Anwendung für den aktuellen Thread ohne Formular.
Öffentliche Methode Statischer Member Run(ApplicationContext) Beginnt die Ausführung einer Standardnachrichtenschleife einer Anwendung für den aktuellen Thread mit einem ApplicationContext.
Öffentliche Methode Statischer Member Run(Form) Beginnt die Ausführung einer Standardnachrichtenschleife einer Anwendung für den aktuellen Thread und zeigt das angegebene Formular an.
Öffentliche Methode Statischer Member SetCompatibleTextRenderingDefault Legt für die gesamte Anwendung die Voreinstellung für die UseCompatibleTextRendering-Eigenschaft fest, die in bestimmten Steuerelementen definiert ist.
Öffentliche Methode Statischer Member SetSuspendState Versetzt das System in den Standbymodus oder Ruhezustand oder fordert an, dass das System in den Standbymodus oder Ruhezustand versetzt wird.
Öffentliche Methode Statischer Member SetUnhandledExceptionMode(UnhandledExceptionMode) Weist die Anwendung an, wie auf unbehandelte Ausnahmen reagiert werden soll.
Öffentliche Methode Statischer Member SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) Weist die Anwendung an, wie auf nicht behandelte Ausnahmen reagiert werden soll, und wendet optional threadspezifisches Verhalten an.
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche Methode Statischer Member UnregisterMessageLoop Hebt die Registrierung des mit RegisterMessageLoop vorgenommenen Nachrichtenschleifenrückrufs auf.
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Statischer Member ApplicationExit Tritt ein, wenn die Anwendung gerade beendet wird.
Öffentliches Ereignis Statischer Member EnterThreadModal Tritt ein, bevor die Anwendung in einen modalen Zustand übergeht.
Öffentliches Ereignis Statischer Member Idle Tritt ein, wenn die Anwendung die Verarbeitung beendet und gerade in den Leerlauf wechselt.
Öffentliches Ereignis Statischer Member LeaveThreadModal Tritt auf, bevor die Anwendung einen modalen Zustand verlässt.
Öffentliches Ereignis Statischer Member ThreadException Tritt beim Auslösen einer nicht abgefangenen Threadausnahme ein.
Öffentliches Ereignis Statischer Member ThreadExit Tritt ein, wenn ein Thread gerade beendet wird. Wenn der Hauptthread für eine Anwendung beendet werden soll, wird zuerst dieses Ereignis und anschließend ein ApplicationExit-Ereignis ausgelöst.
Zum Seitenanfang

Die Application-Klasse verfügt über die folgenden Methoden zum Starten und Beenden von Anwendungen und Threads und zum Verarbeiten von Windows-Meldungen:

  • Run startet eine Nachrichtenschleife einer Anwendung für den aktuellen Thread und zeigt wahlweise ein Formular an.

  • Exit oder ExitThread beendet eine Nachrichtenschleife.

  • DoEvents verarbeitet Meldungen, während sich das Programm in einer Schleife befindet.

  • AddMessageFilter fügt dem Nachrichtensystem der Anwendung für die Überwachung von Windows-Meldungen einen Meldungsfilter hinzu.

  • Mit IMessageFilter können Sie das Auslösen eines Ereignisses beenden oder bestimmte Vorgänge durchführen, bevor ein Ereignishandler aufgerufen wird.

Diese Klasse verfügt über CurrentCulture-Eigenschaften und CurrentInputLanguage-Eigenschaften zum Abrufen oder Festlegen von Kulturinformationen für den aktuellen Thread.

Sie können keine Instanz dieser Klasse erstellen.

Im folgenden Codebeispiel werden in einem Formular Zahlen in einem Listenfeld aufgeführt. Bei jedem Klicken auf button1 wird der Liste durch die Anwendung eine weitere Zahl hinzugefügt.

Die Main-Methode ruft Run auf, um die Anwendung zu starten, die das Formular, listBox1 und button1, erstellt. Wenn der Benutzer auf button1 klickt, zeigt die button1_Click-Methode eine MessageBox an. Wenn der Benutzer in der MessageBox auf No klickt, fügt die button1_Click-Methode der Liste eine Zahl hinzu. Wenn der Benutzer auf Yes klickt, ruft die Anwendung Exit auf, um alle verbliebenen Meldungen in der Warteschlange zu verarbeiten und die Anwendung daraufhin zu beenden.

Hinweis Hinweis

Der Aufruf von Exit schlägt bei partieller Vertrauenswürdigkeit fehl.


public class Form1 : Form
{
    [STAThread]
    public static void Main()
    {
        // Start the application.
        Application.Run(new Form1());
    }

    private Button button1;
    private ListBox listBox1;

    public Form1()
    {
        button1 = new Button();
        button1.Left = 200;
        button1.Text = "Exit";
        button1.Click += new EventHandler(button1_Click);

        listBox1 = new ListBox();
        this.Controls.Add(button1);
        this.Controls.Add(listBox1);
    }

    private void button1_Click(object sender, System.EventArgs e)
    {
        int count = 1;
        // Check to see whether the user wants to exit the application.
        // If not, add a number to the list box.
        while (MessageBox.Show("Exit application?", "", 
            MessageBoxButtons.YesNo)==DialogResult.No)
        {
            listBox1.Items.Add(count);
            count += 1;
        }

        // The user wants to exit the application. 
        // Close everything down.
        Application.Exit();
    }
}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ