Application.StartupUri Application.StartupUri Application.StartupUri Application.StartupUri Property

定義

アプリケーションの起動時に自動的に表示される UI を取得または設定します。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

プロパティ値

Uriアプリケーションの起動時に自動的に開く UI を参照する。A Uri that refers to the UI that automatically opens when an application starts.

例外

StartupUri に null の値が設定されています。StartupUri is set with a value of null.

注釈

を使用StartupUriすると、アプリケーションの起動時に UI リソースを自動的に読み込むことができます。You can use StartupUri to automatically load a UI resource when an application starts.

次の表は、読み込むことができる UI リソースの種類、それらが開かれるウィンドウの種類、およびこれらのリソースをとしてStartupUri設定できるアプリケーションの種類を示しています。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.

Type ウィンドウWindow アプリケーションの種類Application type
Window Window スタンドアロンのみStandalone only
NavigationWindow NavigationWindow スタンドアロンのみStandalone only
Page NavigationWindow スタンドアロン/ブラウザーでホストStandalone/browser-hosted
UserControl NavigationWindow スタンドアロン/ブラウザーでホストStandalone/browser-hosted
FlowDocument NavigationWindow スタンドアロン/ブラウザーでホストStandalone/browser-hosted
PageFunction<T> NavigationWindow スタンドアロン/ブラウザーでホストStandalone/browser-hosted

通常、プロパティは、 StartupUriで宣言にXAMLXAMLよって設定します。Typically, you set the StartupUri property declaratively in XAMLXAML. ただし、必要な UI StartupUriリソースを実行時にしかStartup読み込むことができないアプリケーションの場合は、イベントハンドラーなどを使用してプログラムで設定できます。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. たとえば、UI リソースの名前が構成ファイルに格納されている場合、アプリケーションは実行時まで待機してリソースを読み込むことができます。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.

宣言またはStartupUriプログラムによって設定されている場合でも、対応Startupする UI リソースはイベントが処理されるまで読み込まれません。Whether you set StartupUri declaratively or programmatically, the corresponding UI resource is not loaded until after the Startup event is handled. そのため、処理Windows Startup時にプロパティMainWindowまたはプロパティから結果のウィンドウにアクセスすることはできません。Consequently, you won't have access to the resulting window from either the Windows property or the MainWindow property when handling Startup.

適用対象