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、ExitRun、ShutdownSessionEnding、ShutdownMode、Startup。
應用程式範圍視窗、屬性和資源管理:FindResource、GetContentStream、、ResourcesMainWindowStartupUriLoadComponentWindowsGetResourceStreamProperties、 。
命令行參數和結束程式代碼處理:Application.Startup、、Application.ExitApplication.Shutdown。
流覽:FragmentNavigation、、LoadCompletedNavigated、、NavigatingNavigationProgress、NavigationFailedNavigationStopped、、SetCookieGetCookie
Application 會實作單一模式,以提供其視窗、屬性和資源範圍服務的共用存取權。 因此,每個 AppDomain只能建立類別的Application一個實例。
您可以使用標記、標記和程式代碼後置或程式代碼來實 Application 作 。 如果使用 Application 標記或標記和程式代碼後置來實作,則必須將標記檔案設定為 Microsoft 組建引擎, (MSBuild) ApplicationDefinition
專案。
注意
獨立應用程式不需要 Application 物件;您可以實作自定義 static
進入點方法, () Main
開啟視窗而不建立 的 Application實例。 不過, (XBAP) XAML 瀏覽器應用程式需要 Application 物件。
建構函式
Application() |
初始化 Application 類別的新執行個體。 |
屬性
Current |
取得目前 Application 的 AppDomain 物件。 |
Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
MainWindow |
取得或設定應用程式的主視窗。 |
Properties |
取得應用程式範圍的屬性集合。 |
ResourceAssembly |
取得或設定 , Assembly 提供 WPF 應用程式中資源的套件統一資源識別碼 (URI) 。 |
Resources |
取得或設定應用程式範圍的資源集合,例如樣式和筆刷。 |
ShutdownMode |
取得或設定會導致呼叫 Shutdown() 方法的條件。 |
StartupUri |
取得或設定當應用程式啟動時會自動顯示的 UI。 |
ThemeMode |
封裝 Windows Presentation Foundation 應用程式。 |
Windows |
取得應用程式中已具現化的視窗。 |
方法
事件
Activated |
當應用程式變成前景應用程式時發生。 |
Deactivated |
當應用程式不再做為前景應用程式時發生。 |
DispatcherUnhandledException |
當應用程式擲回例外狀況但未處理時發生。 |
Exit |
會在應用程式關閉且無法取消之前發生。 |
FragmentNavigation |
當應用程式中的導覽器開始瀏覽至內容片段時發生,如果所需的片段位於目前內容中,或當所需的片段位於不同的內容中時,或載入來源 XAML 內容之後,就會立即發生導覽。 |
LoadCompleted |
當應用程式中的巡覽器所巡覽的內容已載入、剖析和開始呈現時發生。 |
Navigated |
當找到應用程式中的巡覽器所巡覽的內容時發生,即使可能未完整載入也一樣。 |
Navigating |
當應用程式中的巡覽器要求新的巡覽時發生。 |
NavigationFailed |
當應用程式中的巡覽器巡覽至要求的內容而發生錯誤時發生。 |
NavigationProgress |
在應用程式中巡覽器所管理的下載期間定期發生,以提供巡覽進度資訊。 |
NavigationStopped |
當呼叫應用程式中巡覽器的 |
SessionEnding |
當使用者登出或關閉作業系統而結束 Windows 工作階段時發生。 |
Startup |
呼叫 Run() 物件的 Application 方法時發生。 |
明確介面實作
IQueryAmbient.IsAmbientPropertyAvailable(String) |
查詢目前範圍中是否有指定的環境屬性。 |
適用於
執行緒安全性
Visual Basic 中的公用 static
Shared
() 此類型的成員是安全線程。 此外, FindResource(Object) 和 TryFindResource(Object) 方法和 Properties 和 Resources 屬性都是安全線程。