Application Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zapouzdřuje aplikaci 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
- Dědičnost
- Implementuje
Příklady
Následující příklad ukazuje, jak je standardní aplikace definována pouze pomocí značek:
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
Následující příklad ukazuje, jak je standardní aplikace definována pouze pomocí kódu:
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
Následující příklad ukazuje, jak je standardní aplikace definována pomocí kombinace značek a kódu na pozadí.
<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
Poznámky
Application je třída, která zapouzdřuje funkce specifické pro WPF (Windows Presentation Foundation) aplikace, včetně následujících:
Životnost aplikace: Activated, Current, Deactivated, DispatcherUnhandledException, ExitRunSessionEndingShutdown, ShutdownMode, . Startup
Application-Scope Window, Property, and Resource Management: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, StartupUri, Windows.
Command-Line zpracování parametru a ukončovacího kódu: Application.Startup, Application.Exit, Application.Shutdown.
Navigace: FragmentNavigation, LoadCompleted, , Navigated, Navigating, NavigationProgressNavigationStopped, NavigationFailed, SetCookie. GetCookie
Application implementuje jeden vzor pro poskytování sdíleného přístupu k jeho oknem, vlastnostem a službám oboru prostředků. V důsledku toho lze vytvořit pouze jednu instanci Application třídy na každou AppDomain.
Můžete implementovat Application pomocí značek, značek a kódu nebo kódu. Pokud je Application implementována s kódem, ať už značkou nebo kódem a za kódem, musí být soubor revizí nakonfigurovaný jako modul sestavení Microsoft (MSBuild) ApplicationDefinition položka.
Note
Samostatná aplikace nevyžaduje Application objekt; je možné implementovat vlastní static metodu vstupního Mainbodu (Application), která otevře okno bez vytvoření instance . Aplikace prohlížeče XAML (XBAPs) však vyžadují Application objekt.
Konstruktory
| Name | Description |
|---|---|
| Application() |
Inicializuje novou instanci Application třídy. |
Vlastnosti
| Name | Description |
|---|---|
| Current |
Application Získá objekt pro aktuální AppDomain. |
| Dispatcher |
Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject) |
| MainWindow |
Získá nebo nastaví hlavní okno aplikace. |
| Properties |
Získá kolekci vlastností oboru aplikace. |
| ResourceAssembly |
Získá nebo nastaví Assembly, který poskytuje identifikátory URI balíčku pro prostředky v WPF (Windows Presentation Foundation) aplikaci. |
| Resources |
Získá nebo nastaví kolekci prostředků oboru aplikace, jako jsou styly a štětce. |
| ShutdownMode |
Získá nebo nastaví podmínku, která způsobí Shutdown() , že metoda bude volána. |
| StartupUri |
Získá nebo nastaví uživatelské rozhraní, které se automaticky zobrazí při spuštění aplikace. |
| ThemeMode |
Získá nebo nastaví Fluent režim motivu aplikace. |
| Windows |
Získá instance oken v aplikaci. |
Metody
| Name | Description |
|---|---|
| CheckAccess() |
Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FindResource(Object) |
Vyhledá prostředek uživatelského rozhraní (UI), například Style prostředek nebo Brushs zadaným klíčem, a vyvolá výjimku, pokud požadovaný prostředek nenajde (viz prostředky XAML). |
| GetContentStream(Uri) |
Vrátí datový proud prostředku pro datový soubor obsahu umístěný v zadaném Uri (viz WPF (Windows Presentation Foundation) Prostředek aplikace, obsah a datové soubory). |
| GetCookie(Uri) |
Načte soubor cookie pro umístění určeného parametrem Uri. |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetRemoteStream(Uri) |
Vrátí datový proud prostředku pro datový soubor původu lokality umístěný v zadaném Uri (viz WPF (Windows Presentation Foundation) Prostředek aplikace, obsah a datové soubory). |
| GetResourceStream(Uri) |
Vrátí datový proud prostředku pro datový soubor prostředků umístěný v zadaném Uri (viz WPF (Windows Presentation Foundation) Prostředek aplikace, obsah a datové soubory). |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| LoadComponent(Object, Uri) |
Načte soubor XAML umístěný na zadaném identifikátoru URI (Uniform Resource Identifier) a převede ho na instanci objektu určeného kořenovým prvkem souboru XAML. |
| LoadComponent(Uri) |
Načte soubor XAML umístěný v zadaném identifikátoru URI (Uniform Resource Identifier) a převede ho na instanci objektu určeného kořenovým prvkem souboru XAML. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnActivated(EventArgs) |
Activated Vyvolá událost. |
| OnDeactivated(EventArgs) |
Deactivated Vyvolá událost. |
| OnExit(ExitEventArgs) |
Exit Vyvolá událost. |
| OnFragmentNavigation(FragmentNavigationEventArgs) |
FragmentNavigation Vyvolá událost. |
| OnLoadCompleted(NavigationEventArgs) |
LoadCompleted Vyvolá událost. |
| OnNavigated(NavigationEventArgs) |
Navigated Vyvolá událost. |
| OnNavigating(NavigatingCancelEventArgs) |
Navigating Vyvolá událost. |
| OnNavigationFailed(NavigationFailedEventArgs) |
NavigationFailed Vyvolá událost. |
| OnNavigationProgress(NavigationProgressEventArgs) |
NavigationProgress Vyvolá událost. |
| OnNavigationStopped(NavigationEventArgs) |
NavigationStopped Vyvolá událost. |
| OnSessionEnding(SessionEndingCancelEventArgs) |
SessionEnding Vyvolá událost. |
| OnStartup(StartupEventArgs) |
Startup Vyvolá událost. |
| Run() |
Spustí aplikaci Windows Presentation Foundation. |
| Run(Window) |
Spustí aplikaci Windows Presentation Foundation a otevře zadané okno. |
| SetCookie(Uri, String) |
Vytvoří soubor cookie pro umístění určeného parametrem Uri. |
| Shutdown() |
Vypne aplikaci. |
| Shutdown(Int32) |
Vypne aplikaci, která vrátí zadaný ukončovací kód do operačního systému. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TryFindResource(Object) |
Vyhledá zadaný prostředek. |
| VerifyAccess() |
Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |
Událost
| Name | Description |
|---|---|
| Activated |
Nastane, když se aplikace stane aplikací na popředí. |
| Deactivated |
Nastane, když aplikace přestane být popředí aplikace. |
| DispatcherUnhandledException |
Nastane v případě, že aplikace vyvolá výjimku, ale nezpracuje ji. |
| Exit |
Nastane těsně před vypnutím aplikace a nelze ji zrušit. |
| FragmentNavigation |
Nastane, když navigátor v aplikaci začne navigaci na fragment obsahu, navigace nastane okamžitě, pokud je požadovaný fragment v aktuálním obsahu nebo po načtení zdrojového obsahu XAML, pokud je požadovaný fragment v jiném obsahu. |
| LoadCompleted |
Nastane, když je obsah, ke kterému byl v aplikaci přecháděný navigátorem načten, analyzován a začal vykreslovat. |
| Navigated |
Nastane, když byl nalezen obsah, ke kterému se v aplikaci přecházejí navigátor, i když se pravděpodobně nedokončilo načítání. |
| Navigating |
Nastane v případě, že navigátor v aplikaci požaduje novou navigaci. |
| NavigationFailed |
Nastane, když dojde k chybě, když navigátor v aplikaci přejde na požadovaný obsah. |
| NavigationProgress |
Probíhá pravidelně během stahování, které je spravováno navigátorem v aplikaci, aby poskytoval informace o průběhu navigace. |
| NavigationStopped |
Nastane, |
| SessionEnding |
Nastane, když uživatel ukončí relaci Windows tím, že se odhlásí nebo vypne operační systém. |
| Startup |
Nastane, Run() když je volána metoda objektu Application . |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
Dotazy na to, zda je zadaná okolí vlastnost k dispozici v aktuálním oboru. |
Platí pro
Bezpečný přístup z více vláken
Veřejné členy static (Shared v Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Kromě toho jsou FindResource(Object) metody a TryFindResource(Object) vlastnosti vlákna PropertiesResources bezpečné.