Application.StartupUri Eigenschaft

Definition

Ruft eine Benutzeroberfläche ab, die automatisch angezeigt wird, wenn die Anwendung startet, oder legt diese fest.Gets or sets a UI that is automatically shown when an application starts.

public:
 property Uri ^ StartupUri { Uri ^ get(); void set(Uri ^ value); };
public Uri StartupUri { get; set; }
member this.StartupUri : Uri with get, set
Public Property StartupUri As Uri

Eigenschaftswert

Uri

Eine Uri, die sich auf die Benutzeroberfläche bezieht, die beim Start einer Anwendung automatisch geöffnet wird.A Uri that refers to the UI that automatically opens when an application starts.

Ausnahmen

StartupUri wird auf den Wert NULL festgelegt.StartupUri is set with a value of null.

Hinweise

Sie können StartupUri verwenden, um beim Starten einer Anwendung automatisch eine UI-Ressource zu laden.You can use StartupUri to automatically load a UI resource when an application starts.

In der folgenden Tabelle werden die Typen von UI-Ressourcen, die geladen werden können, der Typ des Fensters, in dem Sie geöffnet werden, und der Anwendungstyp angezeigt, der als StartupUrifestgelegt werden kann.The following table shows the types of UI resources that can be loaded, the type of window they are opened into, and the type of application that these resources can be set as the StartupUri.

TypType FensterWindow AnwendungstypApplication type
Window Window Nur eigenständigStandalone only
NavigationWindow NavigationWindow Nur eigenständigStandalone only
Page NavigationWindow Eigenständig/Browser gehostetStandalone/browser-hosted
UserControl NavigationWindow Eigenständig/Browser gehostetStandalone/browser-hosted
FlowDocument NavigationWindow Eigenständig/Browser gehostetStandalone/browser-hosted
PageFunction<T> NavigationWindow Eigenständig/Browser gehostetStandalone/browser-hosted

In der Regel legen Sie die StartupUri-Eigenschaft in XAMLXAMLdeklarativ fest.Typically, you set the StartupUri property declaratively in XAMLXAML. Sie können StartupUri jedoch Programm gesteuert festlegen, z. b. von einem Startup-Ereignishandler, der bei Anwendungen nützlich ist, die nur die erforderlichen UI-Ressourcen zur Laufzeit laden können.However, you can set StartupUri programmatically, such as from a Startup event handler, which is useful if for applications that can only load the necessary UI resources at run time. Beispielsweise kann eine Anwendung bis zur Laufzeit warten, um Ihre Ressourcen zu laden, wenn der Name der UI-Ressource in einer Konfigurationsdatei gespeichert ist.For example, an application might wait until run time to load its resources if the name of the UI resource is stored in a configuration file.

Unabhängig davon, ob Sie StartupUri deklarativ oder Programm gesteuert festlegen, wird die entsprechende UI-Ressource erst geladen, nachdem das Startup-Ereignis behandelt wurde.Whether you set StartupUri declaratively or programmatically, the corresponding UI resource is not loaded until after the Startup event is handled. Folglich haben Sie bei der Behandlung von Startupkeinen Zugriff auf das resultierende Fenster entweder über die Windows-Eigenschaft oder die MainWindow-Eigenschaft.Consequently, you won't have access to the resulting window from either the Windows property or the MainWindow property when handling Startup.

Gilt für: