Application Класс

Определение

Инкапсулирует приложение Windows Presentation Foundation.Encapsulates a Windows Presentation Foundation application.

public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient
public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient
type Application = class
    inherit DispatcherObject
    interface IQueryAmbient
Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient
Наследование
Application
Реализации

Примеры

В следующем примере показано, как стандартное приложение определяется с использованием только разметки:The following example shows how a standard application is defined using only markup:

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

В следующем примере показано, как стандартное приложение определяется с использованием только кода.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

В следующем примере показано определение стандартного приложения с помощью сочетания разметки и кода программной части.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

Комментарии

Application — это класс, который инкапсулирует WPFWPF функции конкретного приложения, включая следующие:Application is a class that encapsulates WPFWPF application-specific functionality, including the following:

Application реализует Одноэлементный шаблон для предоставления общего доступа к службам окна, свойства и области ресурсов.Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. Следовательно, для каждой AppDomainможно создать только один экземпляр класса Application.Consequently, only one instance of the Application class can be created per AppDomain.

Можно реализовать Application с помощью разметки, разметки и кода программной части или кода.You can implement an Application using markup, markup and code-behind, or code. Если Application реализуется с разметкой, независимо от того, размещается ли разметка или разметка и код программной части, файл разметки должен быть настроен как элемент Microsoft Build Engine (MSBuild)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)Microsoft build engine (MSBuild) ApplicationDefinition item.

Примечание

Для автономного приложения не требуется объект Application; можно реализовать пользовательский метод точки входа static (Main), который открывает окно без создания экземпляра 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. Однако XAML-приложения браузера (XBAP)XAML browser applications (XBAPs) требуется объект Application.However, XAML-приложения браузера (XBAP)XAML browser applications (XBAPs) require an Application object.

Конструкторы

Application()

Инициализирует новый экземпляр класса Application.Initializes a new instance of the Application class.

Свойства

Current

Возвращает объект Application текущего AppDomain.Gets the Application object for the current AppDomain.

Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject)
MainWindow

Получает или задает главное окно приложения.Gets or sets the main window of the application.

Properties

Возвращает коллекцию свойств области приложения.Gets a collection of application-scope properties.

ResourceAssembly

Получает или задает Assembly, обеспечивающий набор универсальных кодов ресурса (URI) для ресурсов приложения WPFWPF.Gets or sets the Assembly that provides the pack uniform resource identifiers (URIs) for resources in a WPFWPF application.

Resources

Получает или задает коллекцию ресурсов области приложения, например, стилей и кистей.Gets or sets a collection of application-scope resources, such as styles and brushes.

ShutdownMode

Получает или задает условие, которое является причиной вызова метода Shutdown().Gets or sets the condition that causes the Shutdown() method to be called.

StartupUri

Получает или задает пользовательский интерфейс, отображающееся автоматически при запуске приложения.Gets or sets a UI that is automatically shown when an application starts.

Windows

Возвращает созданные окна приложения.Gets the instantiated windows in an application.

Методы

CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindResource(Object)

Осуществляет поиск ресурса пользовательский интерфейсuser interface (UI), например Style или Brush, с указанным ключом и генерирует исключение, если запрошенный ресурс не найден (см. Ресурсы 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)

Возвращает поток ресурса для файла данных содержания, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).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)

Возвращает файл cookie для расположения, указанного Uri.Retrieves a cookie for the location specified by a Uri.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetRemoteStream(Uri)

Возвращает поток ресурса для исходного файла данных ресурса, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).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)

Возвращает поток ресурса для файла данных ресурса, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).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()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
LoadComponent(Object, Uri)

Загружает файл XAMLXAML, расположенный по указанному универсальному коду ресурса (URI), и преобразует его в экземпляр объекта, заданного корневым элементом файла XAMLXAML.Loads a XAMLXAML 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 XAMLXAML file.

LoadComponent(Uri)

Загружает файл XAMLXAML, расположенный по указанному универсальному коду ресурса (URI), и преобразует его в экземпляр объекта, заданного корневым элементом файла XAMLXAML.Loads a XAMLXAML 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 XAMLXAML file.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnActivated(EventArgs)

Создает событие Activated.Raises the Activated event.

OnDeactivated(EventArgs)

Создает событие Deactivated.Raises the Deactivated event.

OnExit(ExitEventArgs)

Вызывает событие Exit.Raises the Exit event.

OnFragmentNavigation(FragmentNavigationEventArgs)

Вызывает событие FragmentNavigation.Raises the FragmentNavigation event.

OnLoadCompleted(NavigationEventArgs)

Создает событие LoadCompleted.Raises the LoadCompleted event.

OnNavigated(NavigationEventArgs)

Создает событие Navigated.Raises the Navigated event.

OnNavigating(NavigatingCancelEventArgs)

Создает событие Navigating.Raises the Navigating event.

OnNavigationFailed(NavigationFailedEventArgs)

Создает событие NavigationFailed.Raises the NavigationFailed event.

OnNavigationProgress(NavigationProgressEventArgs)

Создает событие NavigationProgress.Raises the NavigationProgress event.

OnNavigationStopped(NavigationEventArgs)

Вызывает событие NavigationStopped.Raises the NavigationStopped event.

OnSessionEnding(SessionEndingCancelEventArgs)

Создает событие SessionEnding.Raises the SessionEnding event.

OnStartup(StartupEventArgs)

Создает событие Startup.Raises the Startup event.

Run()

Запускает приложение Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

Run(Window)

Запускает приложение Windows Presentation Foundation с открытием указанного окна.Starts a Windows Presentation Foundation application and opens the specified window.

SetCookie(Uri, String)

Создает файл cookie для расположения, указанного Uri.Creates a cookie for the location specified by a Uri.

Shutdown()

Завершить работу приложения.Shuts down an application.

Shutdown(Int32)

Завершает работу приложения и передает указанный код завершения операционной системой.Shuts down an application that returns the specified exit code to the operating system.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TryFindResource(Object)

Осуществляет поиск указанного ресурса.Searches for the specified resource.

VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)

События

Activated

Происходит, когда приложение становиться активным.Occurs when an application becomes the foreground application.

Deactivated

Происходит, когда приложение перестает быть активным.Occurs when an application stops being the foreground application.

DispatcherUnhandledException

Происходит при генерации приложением исключения, которое не обрабатывается.Occurs when an exception is thrown by an application but not handled.

Exit

Генерируется непосредственно перед завершением работы приложения и не может быть отменено.Occurs just before an application shuts down, and cannot be canceled.

FragmentNavigation

Происходит, когда начинается переход к фрагменту содержимого, Переход происходит сразу же, если желаемый фрагмент находится в текущем содержимом, или после загрузки исходного содержимого XAMLXAML, если желаемый фрагмент находится в другом содержимом.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 XAMLXAML content has been loaded if the desired fragment is in different content.

LoadCompleted

Происходит после того, как содержимое, переданное приложению, было загружено, проанализировано и отрисовывается.Occurs when content that was navigated to by a navigator in the application has been loaded, parsed, and has begun rendering.

Navigated

Происходит, когда содержимое, к которому осуществляется переход, найдено, хотя его загрузка, возможно, еще не завершена.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

Происходит при запросе приложением перехода.Occurs when a new navigation is requested by a navigator in the application.

NavigationFailed

Происходит, когда происходит ошибка при переходе к указанному содержимому.Occurs when an error occurs while a navigator in the application is navigating to the requested content.

NavigationProgress

Происходит время от времени во время загрузки, управляемой приложением для предоставления информации о статусе загрузки.Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information.

NavigationStopped

Появляется при вызове метода перехода приложения StopLoading, или когда поступил запрос нового перехода во время выполнения текущего.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

Происходит, когда пользователь завершает сеанс Windows, выходя из системы или завершая работу операционной системы.Occurs when the user ends the Windows session by logging off or shutting down the operating system.

Startup

Происходит при вызове метода Run() объекта Application.Occurs when the Run() method of the Application object is called.

Явные реализации интерфейса

IQueryAmbient.IsAmbientPropertyAvailable(String)

Запрашивает, доступно ли заданное внешнее свойство в текущей области.Queries for whether a specified ambient property is available in the current scope.

Применяется к

Потокобезопасность

Элементы Public static (Shared в Visual Basic) этого типа являются потокобезопасными.The public static (Shared in Visual Basic) members of this type are thread safe. Кроме того, методы FindResource(Object) и TryFindResource(Object), а также свойства Properties и Resources являются потокобезопасными.In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.

Дополнительно