Application Класс

Определение

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

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
Наследование
Application
Реализации

Примеры

В следующем примере показано, как стандартное приложение определяется с использованием только разметки:

<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, относящиеся к приложению, включая следующие:

Application реализует Одноэлементный шаблон для предоставления общего доступа к службам окна, свойства и области ресурсов. Следовательно, для каждого экземпляра можно создать только один экземпляр Application класса AppDomain .

Можно реализовать Application с помощью разметки, разметки и кода программной части или кода. Если Application реализуется с разметкой (разметка или разметка и код программной части), то файл разметки должен быть настроен как элемент Microsoft Build Engine (MSBuild) ApplicationDefinition .

Примечание

Для автономного приложения не требуется Application объект; можно реализовать пользовательский static метод точки входа ( Main ), который открывает окно без создания экземпляра Application . Однако для приложений браузера XAML (XBAP) требуется Application объект.

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

Application()

Инициализирует новый экземпляр класса Application.

Свойства

Current

Возвращает объект Application для текущего AppDomain.

Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.

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

Получает или задает главное окно приложения.

Properties

Возвращает коллекцию свойств области приложения.

ResourceAssembly

Возвращает или задает объект Assembly , предоставляющий универсальные идентификаторы ресурсов (URI) Pack для ресурсов в приложении WPF.

Resources

Получает или задает коллекцию ресурсов области приложения, например, стилей и кистей.

ShutdownMode

Получает или задает условие, которое является причиной вызова метода Shutdown().

StartupUri

Получает или задает пользовательский интерфейс, отображающееся автоматически при запуске приложения.

Windows

Возвращает созданные окна приложения.

Методы

CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.

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

Определяет, равен ли указанный объект текущему объекту.

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

Выполняет поиск ресурса пользовательского интерфейса (например Style Brush , или) с указанным ключом и создает исключение, если запрошенный ресурс не найден (см. раздел ресурсы XAML).

GetContentStream(Uri)

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

GetCookie(Uri)

Возвращает файл cookie для расположения, указанного Uri.

GetHashCode()

Служит хэш-функцией по умолчанию.

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

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

GetResourceStream(Uri)

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

GetType()

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

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

Загружает XAML-файл, расположенный по указанному универсальному идентификатору ресурса (URI), и преобразует его в экземпляр объекта, указанный в корневом элементе файла XAML.

LoadComponent(Uri)

Загружает XAML-файл, расположенный по указанному универсальному идентификатору ресурса (URI), и преобразует его в экземпляр объекта, указанный в корневом элементе файла XAML.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

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

Вызывает событие Activated.

OnDeactivated(EventArgs)

Вызывает событие Deactivated.

OnExit(ExitEventArgs)

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

OnFragmentNavigation(FragmentNavigationEventArgs)

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

OnLoadCompleted(NavigationEventArgs)

Вызывает событие LoadCompleted.

OnNavigated(NavigationEventArgs)

Вызывает событие Navigated.

OnNavigating(NavigatingCancelEventArgs)

Вызывает событие Navigating.

OnNavigationFailed(NavigationFailedEventArgs)

Вызывает событие NavigationFailed.

OnNavigationProgress(NavigationProgressEventArgs)

Вызывает событие NavigationProgress.

OnNavigationStopped(NavigationEventArgs)

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

OnSessionEnding(SessionEndingCancelEventArgs)

Вызывает событие SessionEnding.

OnStartup(StartupEventArgs)

Вызывает событие Startup.

Run()

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

Run(Window)

Запускает приложение Windows Presentation Foundation с открытием указанного окна.

SetCookie(Uri, String)

Создает файл cookie для расположения, указанного Uri.

Shutdown()

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

Shutdown(Int32)

Завершает работу приложения и передает указанный код завершения операционной системой.

ToString()

Возвращает строку, представляющую текущий объект.

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

Осуществляет поиск указанного ресурса.

VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.

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

События

Activated

Происходит, когда приложение становиться активным.

Deactivated

Происходит, когда приложение перестает быть активным.

DispatcherUnhandledException

Происходит при генерации приложением исключения, которое не обрабатывается.

Exit

Происходит непосредственно перед завершением работы приложения и его отменой.

FragmentNavigation

Происходит, когда навигатор в приложении начинает переход к фрагменту содержимого, переход происходит немедленно, если нужный фрагмент находится в текущем содержимом, или после загрузки исходного содержимого XAML, если нужный фрагмент находится в другом содержимом.

LoadCompleted

Происходит после того, как содержимое, переданное приложению, было загружено, проанализировано и отрисовывается.

Navigated

Происходит, когда содержимое, к которому осуществляется переход, найдено, хотя его загрузка, возможно, еще не завершена.

Navigating

Происходит при запросе приложением перехода.

NavigationFailed

Происходит, когда происходит ошибка при переходе к указанному содержимому.

NavigationProgress

Происходит время от времени во время загрузки, управляемой приложением для предоставления информации о статусе загрузки.

NavigationStopped

Появляется при вызове метода перехода приложения StopLoading, или когда поступил запрос нового перехода во время выполнения текущего.

SessionEnding

Происходит, когда пользователь завершает сеанс Windows, выходя из системы или завершая работу операционной системы.

Startup

Происходит при вызове метода Run() объекта Application.

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

IQueryAmbient.IsAmbientPropertyAvailable(String)

Запрашивает, доступно ли заданное внешнее свойство в текущей области.

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

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

Открытые static ( Shared в Visual Basic) члены этого типа являются потокобезопасными. Кроме того, FindResource(Object) методы и TryFindResource(Object) и свойства и Properties Resources являются потокобезопасными.

См. также раздел