Application Класс

Определение

Пространство имен:: System.Windows

Сборка:: PresentationFramework.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инкапсулирует приложение 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

Наследование: Object

DispatcherObject
Application

Реализации: IQueryAmbient

Примеры

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

<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

Время существования приложения: Activated, Deactivated Exit Run Current DispatcherUnhandledException SessionEnding, Shutdown, . Startup ShutdownMode
Application-Scope Окно, свойство и управление ресурсами: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, StartupUri, Windows.
Command-Line параметр и обработка кода выхода: Application.Startup, , Application.Exit Application.Shutdown.
Навигация: FragmentNavigation, LoadCompleted, Navigating NavigationStopped NavigationProgress NavigationFailed Navigated, ; SetCookie GetCookie

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

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

Note

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

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

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

Свойства

Имя	Описание
Current	Application Возвращает объект для текущего AppDomainобъекта.
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
MainWindow	Возвращает или задает главное окно приложения.
Properties	Возвращает коллекцию свойств области приложения.
ResourceAssembly	Возвращает или задает Assembly, предоставляющий универсальные идентификаторы ресурсов (URI) пакета для ресурсов в приложении 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 свойства являются потокобезопасны.

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

Window

Обратная связь

Были ли сведения на этой странице полезными?