Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Application-Klasse

 

Veröffentlicht: Oktober 2016

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.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

System.Object
  System.Windows.Forms.Application

public sealed class Application

NameBeschreibung
System_CAPS_pubpropertySystem_CAPS_staticAllowQuit

Ruft einen Wert ab, der angibt, ob der Aufrufer diese Anwendung beenden kann.

System_CAPS_pubpropertySystem_CAPS_staticCommonAppDataPath

Ruft den Pfad für die Anwendungsdaten ab, die von allen Benutzern gemeinsam genutzt werden.

System_CAPS_pubpropertySystem_CAPS_staticCommonAppDataRegistry

Ruft den Registrierungsschlüssel für die Anwendungsdaten ab, die von allen Benutzern gemeinsam genutzt werden.

System_CAPS_pubpropertySystem_CAPS_staticCompanyName

Ruft den der Anwendung zugeordneten Firmennamen ab.

System_CAPS_pubpropertySystem_CAPS_staticCurrentCulture

Ruft die Kulturinformationen für den aktuellen Thread ab oder legt diese fest.

System_CAPS_pubpropertySystem_CAPS_staticCurrentInputLanguage

Ruft die aktuelle Eingabesprache für den aktuellen Thread ab oder legt diese fest.

System_CAPS_pubpropertySystem_CAPS_staticExecutablePath

Ruft den Pfad einschließlich des Namens der ausführbaren Datei ab, die zum Starten der Anwendung verwendet wurde.

System_CAPS_pubpropertySystem_CAPS_staticLocalUserAppDataPath

Ruft den Pfad für die Anwendungsdaten eines lokalen Benutzers ab, der kein Roaming verwendet.

System_CAPS_pubpropertySystem_CAPS_staticMessageLoop

Ruft einen Wert ab, der angibt, ob für diesen Thread eine Nachrichtenschleife vorhanden ist.

System_CAPS_pubpropertySystem_CAPS_staticOpenForms

Ruft eine Auflistung offener Fenster ab, die sich im Besitz der Anwendung befinden.

System_CAPS_pubpropertySystem_CAPS_staticProductName

Ruft den dieser Anwendung zugeordneten Produktnamen ab.

System_CAPS_pubpropertySystem_CAPS_staticProductVersion

Ruft die dieser Anwendung zugeordnete Produktversion ab.

System_CAPS_pubpropertySystem_CAPS_staticRenderWithVisualStyles

Ruft einen Wert ab, der angibt, ob die aktuelle Anwendung Steuerelemente mit visuellen Stilen zeichnet.

System_CAPS_pubpropertySystem_CAPS_staticSafeTopLevelCaptionFormat

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.

System_CAPS_pubpropertySystem_CAPS_staticStartupPath

Ruft den Pfad ohne den Namen der ausführbaren Datei ab, die zum Starten der Anwendung verwendet wurde.

System_CAPS_pubpropertySystem_CAPS_staticUserAppDataPath

Ruft den Pfad für die Anwendungsdaten eines Benutzers ab.

System_CAPS_pubpropertySystem_CAPS_staticUserAppDataRegistry

Ruft den Registrierungsschlüssel für die Anwendungsdaten eines Benutzers ab.

System_CAPS_pubpropertySystem_CAPS_staticUseWaitCursor

Ruft ab oder legt fest, ob der Wartecursor für alle offenen Formulare der Anwendung verwendet wird.

System_CAPS_pubpropertySystem_CAPS_staticVisualStyleState

Ruft einen Wert ab, der angibt, wie visuelle Stile für Anwendungsfenster übernommen werden.

NameBeschreibung
System_CAPS_pubmethodSystem_CAPS_staticAddMessageFilter(IMessageFilter)

Fügt einen Meldungsfilter zum Überwachen von Windows-Meldungen beim Weiterleiten an das Ziel hinzu.

System_CAPS_pubmethodSystem_CAPS_staticDoEvents()

Verarbeitet alle Windows-Meldungen, die sich derzeit in der Meldungswarteschlange befinden.

System_CAPS_pubmethodSystem_CAPS_staticEnableVisualStyles()

Aktiviert visuelle Stile für die Anwendung.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodSystem_CAPS_staticExit()

Weist alle Nachrichtensysteme an, die Verarbeitung zu beenden, und schließt alle Anwendungsfenster, sobald die Meldungen verarbeitet wurden.

System_CAPS_pubmethodSystem_CAPS_staticExit(CancelEventArgs)

Weist alle Nachrichtensysteme an, die Verarbeitung zu beenden, und schließt alle Anwendungsfenster, sobald die Meldungen verarbeitet wurden.

System_CAPS_pubmethodSystem_CAPS_staticExitThread()

Verlässt die Nachrichtenschleife für den aktuellen Thread und schließt alle Fenster des Threads.

System_CAPS_pubmethodSystem_CAPS_staticFilterMessage(Message)

Führt etwaige Filter für eine Fenstermeldung aus und gibt eine Kopie der geänderten Meldung zurück.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodSystem_CAPS_staticOleRequired()

Initialisiert OLE für den aktuellen Thread.

System_CAPS_pubmethodSystem_CAPS_staticOnThreadException(Exception)

Löst das ThreadException-Ereignis aus.

System_CAPS_pubmethodSystem_CAPS_staticRaiseIdle(EventArgs)

Löst das Idle-Ereignis in gehosteten Szenarien aus.

System_CAPS_pubmethodSystem_CAPS_staticRegisterMessageLoop(Application.MessageLoopCallback)

Registriert einen Rückruf für die Prüfung, ob die Nachrichtenschleife in gehosteten Umgebungen ausgeführt wird.

System_CAPS_pubmethodSystem_CAPS_staticRemoveMessageFilter(IMessageFilter)

Entfernt einen Meldungsfilter aus dem Nachrichtensystem der Anwendung.

System_CAPS_pubmethodSystem_CAPS_staticRestart()

Schließt die Anwendung und startet sofort eine neue Instanz.

System_CAPS_pubmethodSystem_CAPS_staticRun()

Beginnt die Ausführung einer Standardmeldungsschleife einer Anwendung für den aktuellen Thread ohne Formular.

System_CAPS_pubmethodSystem_CAPS_staticRun(ApplicationContext)

Beginnt die Ausführung einer Standardnachrichtenschleife einer Anwendung für den aktuellen Thread mit einem ApplicationContext.

System_CAPS_pubmethodSystem_CAPS_staticRun(Form)

Beginnt die Ausführung einer Standardnachrichtenschleife einer Anwendung für den aktuellen Thread und zeigt das angegebene Formular an.

System_CAPS_pubmethodSystem_CAPS_staticSetCompatibleTextRenderingDefault(Boolean)

Legt für die gesamte Anwendung die Voreinstellung für die UseCompatibleTextRendering-Eigenschaft fest, die in bestimmten Steuerelementen definiert ist.

System_CAPS_pubmethodSystem_CAPS_staticSetSuspendState(PowerState, Boolean, Boolean)

Versetzt das System in den Standbymodus oder Ruhezustand oder fordert an, dass das System in den Standbymodus oder Ruhezustand versetzt wird.

System_CAPS_pubmethodSystem_CAPS_staticSetUnhandledExceptionMode(UnhandledExceptionMode)

Weist die Anwendung an, wie auf unbehandelte Ausnahmen reagiert werden soll.

System_CAPS_pubmethodSystem_CAPS_staticSetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

Weist die Anwendung an, wie auf nicht behandelte Ausnahmen reagiert werden soll, und wendet optional threadspezifisches Verhalten an.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodSystem_CAPS_staticUnregisterMessageLoop()

Hebt die Registrierung des mit RegisterMessageLoop vorgenommenen Nachrichtenschleifenrückrufs auf.

NameBeschreibung
System_CAPS_pubeventSystem_CAPS_staticApplicationExit

Tritt ein, wenn die Anwendung gerade beendet wird.

System_CAPS_pubeventSystem_CAPS_staticEnterThreadModal

Tritt ein, bevor die Anwendung in einen modalen Zustand übergeht.

System_CAPS_pubeventSystem_CAPS_staticIdle

Tritt ein, wenn die Anwendung die Verarbeitung beendet und gerade in den Leerlauf wechselt.

System_CAPS_pubeventSystem_CAPS_staticLeaveThreadModal

Tritt auf, bevor die Anwendung einen modalen Zustand verlässt.

System_CAPS_pubeventSystem_CAPS_staticThreadException

Tritt beim Auslösen einer nicht abgefangenen Threadausnahme ein.

System_CAPS_pubeventSystem_CAPS_staticThreadExit

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.

Die Application -Klasse verfügt über Methoden zum Starten und Beenden von Anwendungen und Threads sowie Windows-Meldungen wie folgt verarbeitet:

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

  • Exit oder ExitThread beendet eine Nachrichtenschleife.

  • DoEvents Nachrichten werden verarbeitet, während das Programm in einer Schleife befindet.

  • AddMessageFilter Fügt einen Meldungsfilter zum Überwachen von Windows-Meldungen Anwendung Nachrichtensystem.

  • IMessageFilter können Sie ein Ereignis ausgelöst wird beendet oder bestimmte Vorgänge durchführen, bevor ein Ereignishandler aufgerufen.

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

Eine Instanz dieser Klasse kann nicht erstellt werden.

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

Die Main -Methodenaufrufe Run zum Starten der Anwendung, die das Formular erstellt, listBox1 und button1. Klickt der Benutzer button1, wird die button1_Click Methode zeigt eine MessageBox. Wenn der Benutzer klickt No auf die MessageBox, die button1_Click -Methode der Liste eine Zahl hinzugefügt. Wenn der Benutzer klickt Yes, ruft die Anwendung Exit zum Verarbeiten aller verbleibenden Nachrichten in der Warteschlange und dann auf Beenden.

System_CAPS_noteHinweis

Der Aufruf von Exit bei teilweiser 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
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: