Application Klasa

Definicja

Hermetyzuje Windows Presentation Foundation aplikacji.Encapsulates a Windows Presentation Foundation application.

public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient
public ref class Application : System::Windows::Threading::DispatcherObject
public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient
public class Application : System.Windows.Threading.DispatcherObject
type Application = class
    inherit DispatcherObject
    interface IQueryAmbient
type Application = class
    inherit DispatcherObject
Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient
Public Class Application
Inherits DispatcherObject
Dziedziczenie
Application
Implementuje

Przykłady

Poniższy przykład pokazuje, jak aplikacja standardowa jest definiowana przy użyciu tylko znaczników:The following example shows how a standard application is defined using only markup:

<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />

Poniższy przykład pokazuje, jak aplikacja standardowa jest definiowana przy użyciu tylko kodu:The following example shows how a standard application is defined using only code:

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

Poniższy przykład pokazuje, jak aplikacja standardowa jest definiowana przy użyciu kombinacji znaczników i kodu.The following example shows how a standard application is defined using a combination of markup and code-behind.

<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 jest klasą, która hermetyzuje funkcje specyficzne dla aplikacji WPF, w tym następujące:Application is a class that encapsulates WPF application-specific functionality, including the following:

Application implementuje wzorzec singleton, aby zapewnić współużytkowany dostęp do jego okna, właściwości i usług zakresu zasobów.Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. W związku z tym można utworzyć tylko jedno wystąpienie Application klasy na AppDomain .Consequently, only one instance of the Application class can be created per AppDomain.

Można zaimplementować Application przy użyciu znaczników, znaczników i kodu.You can implement an Application using markup, markup and code-behind, or code. Jeśli Application jest zaimplementowany przy użyciu znacznika, niezależnie od tego, czy Adiustacja lub znaczniki i kod są powiązane, plik znaczników musi być skonfigurowany jako element Microsoft Build Engine (MSBuild) ApplicationDefinition .If Application is implemented with markup, whether markup or markup and code-behind, the markup file must be configured as an Microsoft build engine (MSBuild) ApplicationDefinition item.

Uwaga

Aplikacja autonomiczna nie wymaga Application obiektu; istnieje możliwość zaimplementowania niestandardowej static metody punktu wejścia ( Main ) otwierającej okno bez tworzenia wystąpienia Application .A standalone application does not require an Application object; it is possible to implement a custom static entry point method (Main) that opens a window without creating an instance of Application. Jednak aplikacje przeglądarki XAML (XBAP) wymagają Application obiektu.However, XAML browser applications (XBAPs) require an Application object.

Konstruktory

Application()

Inicjuje nowe wystąpienie klasy Application.Initializes a new instance of the Application class.

Właściwości

Current

Pobiera Application obiekt dla bieżącego elementu AppDomain .Gets the Application object for the current AppDomain.

Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
MainWindow

Pobiera lub ustawia okno główne aplikacji.Gets or sets the main window of the application.

Properties

Pobiera kolekcję właściwości zakresu aplikacji.Gets a collection of application-scope properties.

ResourceAssembly

Pobiera lub ustawia wartość Assembly , która zapewnia identyfikatory URI (Uniform Resource Identifier) dla zasobów w aplikacji WPF.Gets or sets the Assembly that provides the pack uniform resource identifiers (URIs) for resources in a WPF application.

Resources

Pobiera lub ustawia kolekcję zasobów zakresu aplikacji, takich jak style i pędzle.Gets or sets a collection of application-scope resources, such as styles and brushes.

ShutdownMode

Pobiera lub ustawia warunek, który powoduje Shutdown() wywołanie metody.Gets or sets the condition that causes the Shutdown() method to be called.

StartupUri

Pobiera lub ustawia interfejs użytkownika, który jest automatycznie wyświetlany podczas uruchamiania aplikacji.Gets or sets a UI that is automatically shown when an application starts.

Windows

Pobiera okna utworzone w aplikacji.Gets the instantiated windows in an application.

Metody

CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindResource(Object)

Wyszukuje zasób interfejsu użytkownika (UI), taki jak Style lub Brush , z określonym kluczem, i zgłasza wyjątek, jeśli nie odnaleziono żądanego zasobu (zobacz zasoby XAML).Searches for a user interface (UI) resource, such as a Style or Brush, with the specified key, and throws an exception if the requested resource is not found (see XAML Resources).

GetContentStream(Uri)

Zwraca strumień zasobów dla pliku danych zawartości, który znajduje się w określonej lokalizacji Uri (zobacz zasób aplikacji WPF, zawartość i pliki danych).Returns a resource stream for a content data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetCookie(Uri)

Pobiera plik cookie dla lokalizacji określonej przez Uri .Retrieves a cookie for the location specified by a Uri.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetRemoteStream(Uri)

Zwraca strumień zasobów dla pliku danych lokacji, który znajduje się w określonej lokalizacji Uri (zobacz zasób aplikacji WPF, zawartość i pliki danych).Returns a resource stream for a site-of-origin data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetResourceStream(Uri)

Zwraca strumień zasobów dla pliku danych zasobu, który znajduje się w określonej lokalizacji Uri (zobacz zasób aplikacji WPF, zawartość i pliki danych).Returns a resource stream for a resource data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
LoadComponent(Object, Uri)

Ładuje plik XAML, który znajduje się w określonym identyfikatorze URI (Uniform Resource Identifier) i konwertuje go na wystąpienie obiektu, który jest określony przez element główny pliku XAML.Loads a XAML file that is located at the specified uniform resource identifier (URI) and converts it to an instance of the object that is specified by the root element of the XAML file.

LoadComponent(Uri)

Ładuje plik XAML, który znajduje się w określonym identyfikatorze URI (Uniform Resource Identifier) i konwertuje go na wystąpienie obiektu, który jest określony przez element główny pliku XAML.Loads a XAML file that is located at the specified uniform resource identifier (URI), and converts it to an instance of the object that is specified by the root element of the XAML file.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnActivated(EventArgs)

Podnosi Activated zdarzenie.Raises the Activated event.

OnDeactivated(EventArgs)

Podnosi Deactivated zdarzenie.Raises the Deactivated event.

OnExit(ExitEventArgs)

Podnosi Exit zdarzenie.Raises the Exit event.

OnFragmentNavigation(FragmentNavigationEventArgs)

Podnosi FragmentNavigation zdarzenie.Raises the FragmentNavigation event.

OnLoadCompleted(NavigationEventArgs)

Podnosi LoadCompleted zdarzenie.Raises the LoadCompleted event.

OnNavigated(NavigationEventArgs)

Podnosi Navigated zdarzenie.Raises the Navigated event.

OnNavigating(NavigatingCancelEventArgs)

Podnosi Navigating zdarzenie.Raises the Navigating event.

OnNavigationFailed(NavigationFailedEventArgs)

Podnosi NavigationFailed zdarzenie.Raises the NavigationFailed event.

OnNavigationProgress(NavigationProgressEventArgs)

Podnosi NavigationProgress zdarzenie.Raises the NavigationProgress event.

OnNavigationStopped(NavigationEventArgs)

Podnosi NavigationStopped zdarzenie.Raises the NavigationStopped event.

OnSessionEnding(SessionEndingCancelEventArgs)

Podnosi SessionEnding zdarzenie.Raises the SessionEnding event.

OnStartup(StartupEventArgs)

Podnosi Startup zdarzenie.Raises the Startup event.

Run()

Uruchamia aplikację Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

Run(Window)

Uruchamia aplikację Windows Presentation Foundation i otwiera określone okno.Starts a Windows Presentation Foundation application and opens the specified window.

SetCookie(Uri, String)

Tworzy plik cookie dla lokalizacji określonej przez Uri .Creates a cookie for the location specified by a Uri.

Shutdown()

Zamyka aplikację.Shuts down an application.

Shutdown(Int32)

Zamyka aplikację, która zwraca określony kod zakończenia do systemu operacyjnego.Shuts down an application that returns the specified exit code to the operating system.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TryFindResource(Object)

Wyszukuje określony zasób.Searches for the specified resource.

VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Zdarzenia

Activated

Występuje, gdy aplikacja stanie się aplikacją pierwszego planu.Occurs when an application becomes the foreground application.

Deactivated

Występuje, gdy aplikacja przestaje być aplikacją pierwszego planu.Occurs when an application stops being the foreground application.

DispatcherUnhandledException

Występuje, gdy aplikacja zgłasza wyjątek, ale nie jest obsługiwana.Occurs when an exception is thrown by an application but not handled.

Exit

Występuje tuż przed zamknięciem aplikacji i nie można jej anulować.Occurs just before an application shuts down and cannot be canceled.

FragmentNavigation

Występuje, gdy Nawigator w aplikacji rozpoczyna nawigację do fragmentu zawartości, Nawigacja odbywa się 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.Occurs when a navigator in the application begins navigation to a content fragment, Navigation occurs immediately if the desired fragment is in the current content, or after the source XAML content has been loaded if the desired fragment is in different content.

LoadCompleted

Występuje, gdy zawartość, która została przetworzona przez Nawigator w aplikacji, została załadowana, przeanalizowana i rozpoczęto renderowanie.Occurs when content that was navigated to by a navigator in the application has been loaded, parsed, and has begun rendering.

Navigated

Występuje, gdy znaleziono zawartość, do której przejdzie Nawigator w aplikacji, chociaż może nie zakończył ładowania.Occurs when the content that is being navigated to by a navigator in the application has been found, although it may not have completed loading.

Navigating

Występuje, gdy w aplikacji zostanie zlecona Nowa nawigacja.Occurs when a new navigation is requested by a navigator in the application.

NavigationFailed

Występuje, gdy wystąpi błąd, gdy Nawigator w aplikacji przejdzie do żądanej zawartości.Occurs when an error occurs while a navigator in the application is navigating to the requested content.

NavigationProgress

Występuje okresowo podczas pobierania, który jest zarządzany przez Nawigator w aplikacji w celu udostępnienia informacji o postępie nawigacji.Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information.

NavigationStopped

Występuje, gdy StopLoading wywoływana jest metoda nawigatora w aplikacji lub gdy jest wymagana Nowa Nawigacja w trakcie bieżącego nawigowania.Occurs when the StopLoading method of a navigator in the application is called, or when a new navigation is requested by a navigator while a current navigation is in progress.

SessionEnding

Występuje, gdy użytkownik kończy sesję systemu Windows przez wylogowanie lub wyłączenie systemu operacyjnego.Occurs when the user ends the Windows session by logging off or shutting down the operating system.

Startup

Występuje, gdy Run() Application wywoływana jest metoda obiektu.Occurs when the Run() method of the Application object is called.

Jawne implementacje interfejsu

IQueryAmbient.IsAmbientPropertyAvailable(String)

Wykonuje zapytania dotyczące tego, czy określona właściwość otoczenia jest dostępna w bieżącym zakresie.Queries for whether a specified ambient property is available in the current scope.

Dotyczy

Bezpieczeństwo wątkowe

Publiczne static ( Shared w Visual Basic) członkowie tego typu są bezpieczne wątkowo.The public static (Shared in Visual Basic) members of this type are thread safe. Ponadto FindResource(Object) metody i i TryFindResource(Object) właściwości i Properties Resources są bezpieczne wątkowo.In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.

Zobacz też