Application クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows Presentation Foundation アプリケーションをカプセル化します。
public ref class Application : System::Windows::Threading::DispatcherObject
public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient
public class Application : System.Windows.Threading.DispatcherObject
public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient
type Application = class
inherit DispatcherObject
type Application = class
inherit DispatcherObject
interface IQueryAmbient
Public Class Application
Inherits DispatcherObject
Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient
- 継承
- 実装
例
次の例は、マークアップのみを使用して標準アプリケーションを定義する方法を示しています。
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
次の例は、コードのみを使用して標準アプリケーションを定義する方法を示しています。
using System;
using System.Windows;
namespace SDKSample
{
public class AppCode : Application
{
// Entry point method
[STAThread]
public static void Main()
{
AppCode app = new AppCode();
app.Run();
}
}
}
Imports System.Windows
Namespace SDKSample
Public Class AppCode
Inherits Application
' Entry point method
<STAThread>
Public Shared Sub Main()
Dim app As New AppCode()
app.Run()
End Sub
End Class
End Namespace
次の例は、マークアップと分離コードの組み合わせを使用して標準アプリケーションを定義する方法を示しています。
<Application
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="SDKSample.App" />
using System.Windows;
namespace SDKSample
{
public partial class App : Application { }
}
Imports System.Windows
Namespace SDKSample
Partial Public Class App
Inherits Application
End Class
End Namespace
注釈
Application は、次のようなアプリケーション固有の機能WPFカプセル化するクラスです。
アプリケーションの有効期間: Activated、 Current、 Deactivated、 DispatcherUnhandledException、 Exit、 Run、 SessionEnding、 Shutdown、 ShutdownMode、 Startup。
Application-Scope ウィンドウ、プロパティ、およびリソース管理: FindResource、 GetContentStream、GetResourceStream、LoadComponent、MainWindow、Properties、Resources、StartupUri、Windows。
Command-Line パラメーターと終了コード処理: Application.Startup、 Application.Exit、 Application.Shutdown。
ナビゲーション: FragmentNavigation、 LoadCompleted、 Navigated、 Navigating、 NavigationProgress、 NavigationStopped、 NavigationFailed、 SetCookie、 GetCookie。
Application では、シングルトン パターンを実装して、ウィンドウ、プロパティ、およびリソース スコープ サービスへの共有アクセスを提供します。 そのため、AppDomainごとに作成できるApplication クラスのインスタンスは 1 つだけです。
マークアップ、マークアップ、分離コード、またはコードを使用して、 Application を実装できます。 マークアップまたはマークアップと分離コードのいずれ<
Note
スタンドアロン アプリケーションでは、Application オブジェクトは必要ありません。Applicationのインスタンスを作成せずにウィンドウを開くカスタム static エントリ ポイント メソッド (Main) を実装できます。 ただし、XAML ブラウザー アプリケーション (XBAP) には、 Application オブジェクトが必要です。
コンストラクター
| 名前 | 説明 |
|---|---|
| Application() |
Application クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Current |
現在のApplicationのAppDomain オブジェクトを取得します。 |
| Dispatcher |
このDispatcherが関連付けられているDispatcherObjectを取得します。 (継承元 DispatcherObject) |
| MainWindow |
アプリケーションのメイン ウィンドウを取得または設定します。 |
| Properties |
アプリケーション スコープのプロパティのコレクションを取得します。 |
| ResourceAssembly |
WPF アプリケーション内のリソースのパック uniform resource identifier (URI) を提供するAssemblyを取得または設定します。 |
| Resources |
スタイルやブラシなどのアプリケーション スコープ リソースのコレクションを取得または設定します。 |
| ShutdownMode |
Shutdown() メソッドを呼び出す条件を取得または設定します。 |
| StartupUri |
アプリケーションの起動時に自動的に表示される UI を取得または設定します。 |
| Windows |
アプリケーションでインスタンス化されたウィンドウを取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| CheckAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。 (継承元 DispatcherObject) |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| FindResource(Object) |
指定したキーを使用して、 Style や Brushなどのユーザー インターフェイス (UI) リソースを検索し、要求されたリソースが見つからない場合は例外をスローします ( XAML リソースを参照)。 |
| GetContentStream(Uri) |
指定した |
| GetCookie(Uri) |
Uriで指定された場所の Cookie を取得します。 |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetRemoteStream(Uri) |
指定した |
| GetResourceStream(Uri) |
指定した |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| LoadComponent(Object, Uri) |
指定した URI (Uniform Resource Identifier) にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定されたオブジェクトのインスタンスに変換します。 |
| LoadComponent(Uri) |
指定した URI (Uniform Resource Identifier) にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定されたオブジェクトのインスタンスに変換します。 |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| OnActivated(EventArgs) |
Activated イベントを発生させます。 |
| OnDeactivated(EventArgs) |
Deactivated イベントを発生させます。 |
| OnExit(ExitEventArgs) |
Exit イベントを発生させます。 |
| OnFragmentNavigation(FragmentNavigationEventArgs) |
FragmentNavigation イベントを発生させます。 |
| OnLoadCompleted(NavigationEventArgs) |
LoadCompleted イベントを発生させます。 |
| OnNavigated(NavigationEventArgs) |
Navigated イベントを発生させます。 |
| OnNavigating(NavigatingCancelEventArgs) |
Navigating イベントを発生させます。 |
| OnNavigationFailed(NavigationFailedEventArgs) |
NavigationFailed イベントを発生させます。 |
| OnNavigationProgress(NavigationProgressEventArgs) |
NavigationProgress イベントを発生させます。 |
| OnNavigationStopped(NavigationEventArgs) |
NavigationStopped イベントを発生させます。 |
| OnSessionEnding(SessionEndingCancelEventArgs) |
SessionEnding イベントを発生させます。 |
| OnStartup(StartupEventArgs) |
Startup イベントを発生させます。 |
| Run() |
Windows Presentation Foundation アプリケーションを起動します。 |
| Run(Window) |
Windows Presentation Foundation アプリケーションを起動し、指定したウィンドウを開きます。 |
| SetCookie(Uri, String) |
Uriで指定された場所の Cookie を作成します。 |
| Shutdown() |
アプリケーションをシャットダウンします。 |
| Shutdown(Int32) |
指定した終了コードをオペレーティング システムに返すアプリケーションをシャットダウンします。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
| TryFindResource(Object) |
指定したリソースを検索します。 |
| VerifyAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。 (継承元 DispatcherObject) |
イベント
| 名前 | 説明 |
|---|---|
| Activated |
アプリケーションがフォアグラウンド アプリケーションになったときに発生します。 |
| Deactivated |
アプリケーションがフォアグラウンド アプリケーションで停止したときに発生します。 |
| DispatcherUnhandledException |
アプリケーションによって例外がスローされ、処理されない場合に発生します。 |
| Exit |
アプリケーションがシャットダウンする直前に発生し、取り消すことはできません。 |
| FragmentNavigation |
アプリケーションのナビゲーターがコンテンツ フラグメントへのナビゲーションを開始すると発生します。ナビゲーションは、目的のフラグメントが現在のコンテンツ内にある場合は直ちに発生し、目的のフラグメントが異なるコンテンツにある場合はソース XAML コンテンツが読み込まれた直後に発生します。 |
| LoadCompleted |
アプリケーションのナビゲーターによって移動されたコンテンツが読み込まれ、解析され、レンダリングが開始されたときに発生します。 |
| Navigated |
アプリケーション内のナビゲーターによって移動されているコンテンツが見つかったときに発生しますが、読み込みが完了していない可能性があります。 |
| Navigating |
アプリケーションのナビゲーターによって新しいナビゲーションが要求されたときに発生します。 |
| NavigationFailed |
アプリケーションのナビゲーターが要求されたコンテンツに移動しているときにエラーが発生したときに発生します。 |
| NavigationProgress |
ナビゲーションの進行状況情報を提供するために、アプリケーションのナビゲーターによって管理されているダウンロード中に定期的に発生します。 |
| NavigationStopped |
アプリケーション内のナビゲーターの |
| SessionEnding |
ユーザーがオペレーティング システムをログオフまたはシャットダウンして、Windows セッションを終了したときに発生します。 |
| Startup |
Run() オブジェクトのApplication メソッドが呼び出されたときに発生します。 |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
指定したアンビエント プロパティが現在のスコープで使用できるかどうかを照会します。 |
適用対象
スレッド セーフ
この型のパブリック static (Visual Basic の Shared) メンバーはスレッド セーフです。 さらに、 FindResource(Object) メソッドと TryFindResource(Object) メソッド、および Properties プロパティと Resources プロパティはスレッド セーフです。