Application Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Hermetyzuje aplikację 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
- Dziedziczenie
- Implementuje
Przykłady
W poniższym przykładzie pokazano, jak zdefiniowano standardową aplikację przy użyciu tylko znaczników:
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
W poniższym przykładzie pokazano, jak zdefiniowano standardową aplikację przy użyciu tylko kodu:
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
W poniższym przykładzie pokazano, jak zdefiniowano standardową aplikację przy użyciu kombinacji znaczników i kodu w tle.
<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
Uwagi
Application to klasa, która hermetyzuje funkcje specyficzne dla aplikacji WPF, w tym następujące:
Okres istnienia aplikacji: Activated, , DispatcherUnhandledExceptionRunDeactivatedCurrentSessionEndingShutdownExit, . StartupShutdownMode
Okno zakresu aplikacji, właściwość i zarządzanie zasobami: FindResource, , GetContentStreamPropertiesGetResourceStreamMainWindowResourcesLoadComponent, . WindowsStartupUri
Parametr wiersza polecenia i przetwarzanie kodu zakończenia: Application.Startup, Application.Exit, Application.Shutdown.
Nawigacja: FragmentNavigation, NavigatedNavigationStoppedLoadCompletedNavigationProgressNavigationFailedNavigating, SetCookie, . GetCookie
Application implementuje wzorzec pojedynczego, aby zapewnić współużytkowany dostęp do usług okna, właściwości i zakresu zasobów. W związku z tym można utworzyć tylko jedno wystąpienie Application klasy na AppDomain.
Można zaimplementować Application za pomocą znaczników, znaczników i kodu lub kodu. Jeśli Application jest zaimplementowany przy użyciu znaczników, znaczników lub znaczników i kodu w tle, plik znaczników musi być skonfigurowany jako element aparatu kompilacji firmy Microsoft (MSBuild). ApplicationDefinition
Uwaga
Aplikacja autonomiczna nie wymaga Application obiektu. Można zaimplementować niestandardową static
metodę punktu wejścia (Main
), która otwiera okno bez tworzenia wystąpienia obiektu Application. Jednak aplikacje przeglądarki XAML (XBAPs) wymagają Application obiektu.
Konstruktory
Application() |
Inicjuje nowe wystąpienie klasy Application. |
Właściwości
Current |
Application Pobiera obiekt dla bieżącego AppDomainobiektu . |
Dispatcher |
Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject) |
MainWindow |
Pobiera lub ustawia główne okno aplikacji. |
Properties |
Pobiera kolekcję właściwości zakresu aplikacji. |
ResourceAssembly |
Pobiera lub ustawia pakiet Assembly jednolitych identyfikatorów zasobów (URI) dla zasobów w aplikacji WPF. |
Resources |
Pobiera lub ustawia kolekcję zasobów zakresu aplikacji, takich jak style i pędzle. |
ShutdownMode |
Pobiera lub ustawia warunek, który powoduje wywołanie Shutdown() metody. |
StartupUri |
Pobiera lub ustawia interfejs użytkownika, który jest automatycznie wyświetlany po uruchomieniu aplikacji. |
ThemeMode |
Hermetyzuje aplikację Windows Presentation Foundation. |
Windows |
Pobiera utworzone okna w aplikacji. |
Metody
CheckAccess() |
Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
FindResource(Object) |
Wyszukuje zasób interfejsu użytkownika, taki jak lub StyleBrush, z określonym kluczem i zgłasza wyjątek, jeśli żądany zasób nie zostanie znaleziony (zobacz Zasoby XAML). |
GetContentStream(Uri) |
Zwraca strumień zasobów dla pliku danych zawartości, który znajduje się w określonej Uri lokalizacji (zobacz Zasób aplikacji WPF, zawartość i pliki danych). |
GetCookie(Uri) |
Pobiera plik cookie dla lokalizacji określonej przez obiekt Uri. |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetRemoteStream(Uri) |
Zwraca strumień zasobów dla pliku danych typu lokacja źródła, który znajduje się w określonej Uri lokalizacji (zobacz Zasób aplikacji WPF, zawartość i pliki danych). |
GetResourceStream(Uri) |
Zwraca strumień zasobów dla pliku danych zasobu, który znajduje się w określonej Uri lokalizacji (zobacz Zasób aplikacji WPF, Zawartość i Pliki danych). |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
LoadComponent(Object, Uri) |
Ładuje plik XAML znajdujący się w określonym identyfikatorze URI (Uniform Resource Identifier) i konwertuje go na wystąpienie obiektu określonego przez element główny pliku XAML. |
LoadComponent(Uri) |
Ładuje plik XAML znajdujący się w określonym identyfikatorze URI (Uniform Resource Identifier) i konwertuje go na wystąpienie obiektu określonego przez element główny pliku XAML. |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnActivated(EventArgs) |
Activated Zgłasza zdarzenie. |
OnDeactivated(EventArgs) |
Deactivated Zgłasza zdarzenie. |
OnExit(ExitEventArgs) |
Exit Zgłasza zdarzenie. |
OnFragmentNavigation(FragmentNavigationEventArgs) |
FragmentNavigation Zgłasza zdarzenie. |
OnLoadCompleted(NavigationEventArgs) |
LoadCompleted Zgłasza zdarzenie. |
OnNavigated(NavigationEventArgs) |
Navigated Zgłasza zdarzenie. |
OnNavigating(NavigatingCancelEventArgs) |
Navigating Zgłasza zdarzenie. |
OnNavigationFailed(NavigationFailedEventArgs) |
NavigationFailed Zgłasza zdarzenie. |
OnNavigationProgress(NavigationProgressEventArgs) |
NavigationProgress Zgłasza zdarzenie. |
OnNavigationStopped(NavigationEventArgs) |
NavigationStopped Zgłasza zdarzenie. |
OnSessionEnding(SessionEndingCancelEventArgs) |
SessionEnding Zgłasza zdarzenie. |
OnStartup(StartupEventArgs) |
Startup Zgłasza zdarzenie. |
Run() |
Uruchamia aplikację Windows Presentation Foundation. |
Run(Window) |
Uruchamia aplikację Windows Presentation Foundation i otwiera określone okno. |
SetCookie(Uri, String) |
Tworzy plik cookie dla lokalizacji określonej przez obiekt Uri. |
Shutdown() |
Zamyka aplikację. |
Shutdown(Int32) |
Zamyka aplikację, która zwraca określony kod zakończenia do systemu operacyjnego. |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
TryFindResource(Object) |
Wyszukuje określony zasób. |
VerifyAccess() |
Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
Zdarzenia
Activated |
Występuje, gdy aplikacja staje się aplikacją pierwszego planu. |
Deactivated |
Występuje, gdy aplikacja przestaje być aplikacją pierwszego planu. |
DispatcherUnhandledException |
Występuje, gdy wyjątek jest zgłaszany przez aplikację, ale nie jest obsługiwany. |
Exit |
Występuje tuż przed zamknięciem aplikacji i nie można jej anulować. |
FragmentNavigation |
Występuje, gdy nawigator w aplikacji rozpoczyna nawigację do fragmentu zawartości, nawigacja następuje natychmiast, jeśli żądany fragment znajduje się w bieżącej zawartości lub po załadowaniu źródłowej zawartości XAML, jeśli żądany fragment znajduje się w innej zawartości. |
LoadCompleted |
Występuje, gdy zawartość, która została nawigowana przez nawigatora w aplikacji, została załadowana, przeanalizowana i rozpoczęła renderowanie. |
Navigated |
Występuje, gdy zawartość, do którą przechodzi nawigator w aplikacji, została znaleziona, chociaż mogła nie zostać zakończona ładowanie. |
Navigating |
Występuje, gdy nowa nawigacja jest żądana przez nawigatora w aplikacji. |
NavigationFailed |
Występuje, gdy wystąpi błąd podczas nawigatora w aplikacji przechodzącego do żądanej zawartości. |
NavigationProgress |
Występuje okresowo podczas pobierania zarządzanego przez nawigatora w aplikacji w celu zapewnienia informacji o postępie nawigacji. |
NavigationStopped |
Występuje, gdy |
SessionEnding |
Występuje, gdy użytkownik kończy sesję systemu Windows, logując się lub zamykając system operacyjny. |
Startup |
Występuje, gdy Run() wywoływana jest metoda Application obiektu. |
Jawne implementacje interfejsu
IQueryAmbient.IsAmbientPropertyAvailable(String) |
Zapytania dotyczące tego, czy określona właściwość otoczenia jest dostępna w bieżącym zakresie. |
Dotyczy
Bezpieczeństwo wątkowe
static
Publiczne (Shared
w Visual Basic) elementy członkowskie tego typu są bezpieczne wątkami. Ponadto FindResource(Object) metody i i TryFindResource(Object)Properties i Resources są bezpieczne wątkiem.