Application对象
当一个WPF应用程序启动时,首先会实例化一个全局唯一的Application对象,类似于WinForm下的Application类,用于控制整个应用程序,该类将用于追踪应用程序打开的窗口。在应用程序打开或关闭的时候能够触发相应的事件。
创建Application对象
手动创建Application应用程序对象过程:
1、 使用VS创建WPF应用程序,命名为WPFDemo。然后手动清除App.xaml文件。
2、 添加Startup.cs类,并添加程序代码。如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
using System.Windows; //添加windows命名空间
namespace WPFDemo
{
public class Startup
{
[STAThread]
public static void Main()
{
Application app = new Application(); //创建application对象
MainWindow win = new MainWindow(); //实例化窗口对象,作为应用程序主窗口
win.Title = "应用程序主窗口" ; //指定应用程序窗口标题
app.Run(win); //调用Run方法开始运行应用程序
}
}
}
|
3、 F5启动应用程序。
关闭应用程序
Application类提供了一个ShutdownMode的枚举属性值,可以供开发人员指定应用程序的关闭模式。开发人员可以在Application的OnStartup事件为这个属性赋值,也可以在XAML文件中设置这个属性。
ShutdownModel 枚举值
枚举值 |
说明 |
OnLastWindoClose |
当最后一个窗口关闭或在调用Application.Shutdown方法时,应用程序将关闭。 |
OnMainWindowClose |
主窗口关闭或者调用Application.Shutdow方法时,应用程序关闭。 |
OnExplicitShutdown |
即使所有窗口都被关闭,应用程序也不会终止。这个方法适用于一些长时间运行后台任务的场合。当显式调用Application.Shutdown方法后,应用程序才会退出。 |
Application类OnStartup事件中设置ShutdownMode枚举值。
1 2 3 4 5 |
protected override void OnStartup(StartupEventArgs e)
{
base .OnStartup(e);
this .ShutdownMode = ShutdownMode.OnMainWindowClose;
}
|
App.xaml中指定的ShutdownMode值
1 2 3 4 5 6 7 8 9 10 |
<Application x:Class= "WPFDemo.App"
xmlns= "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x= "http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local= "clr-namespace:WPFDemo"
StartupUri= "MainWindow.xaml"
ShutdownMode= "OnLastWindowClose" >
<Application.Resources>
</Application.Resources>
</Application>
|
应用程序事件
应用程序执行将会按照顺序触发下列事件。
1、 Startup:应用程序启动事件。
2、 Activated:当应用程序的顶层窗口被激活时触发此事件。
3、 Deactiveated:当应用程序的顶层窗口失去焦点时触发此事件。
4、 DispatherUnhandledException:当应用程序的产生未处理异常时触发此事件。
5、 SessionEnding:当Windows会话被终止时触发此事件,例如用户注销或关闭计算机。
6、 Exit:当应用程序因为某种原因而被关闭时触发此事件。
Startup 应用程序启动事件
该事件在Run方法被调用后触发,这个事件通常用于放置应用程序范围的初始化信息。获取和设置应用程序范围的配置,处理命令行参数等。该事件提供了StartupEventArgs类型的参数,包含了命令行参数信息。
Startup事件可以完成下列任务。
(1)、处理命令行参数。
(2)、打开主窗口。
(3)、初始化应用程序范围的资源。
(4)、初始化应用程序范围的属性。
Startup事件,首先在App.xaml文件中,去掉StartupUri属性,关联Startup事件处理器。
1 2 3 4 5 6 7 8 9 |
<Application x:Class= "WPFDemo.App"
xmlns= "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x= "http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local= "clr-namespace:WPFDemo"
Startup= "Application_Startup" >
<Application.Resources>
</Application.Resources>
</Application>
|
接下来在 App.xaml.cs 文件中添加下列事件处理器
1 2 3 4 5 |
private void Application_Startup( object sender, StartupEventArgs e)
{
MainWindow win = new WPFDemo.MainWindow();
win.Show();
}
|
在实际项目开发中,OnStartup中的代码可以非常复杂,可以读取应用程序资源或读取应用程序设置中读取配置信息,配置参数等。
Activated和Deactiveated事件
应用程序的激活与Window的激活和取消激活类似,但应用程序的激活通常是指全局应用程序的激活,通常发生在如下情况下:
1、 应用程序打开第一个窗口。
2、 用户使用Alt+Tab组合件或者使用任务管理器切换到该应用程序。
3、 用户单击应用程序中一个窗口的任务栏按钮。
与窗口不同的是,一旦应用程序激活,在应用程序停用前都不会再次引发Activated事件。
在上面示例中新增一个名为Window2.xaml的窗口。并修改OnStartup事件处理器的代码,使其启动时能够显示两个窗口。
1 2 3 4 5 6 7 8 9 10 |
private void Application_Startup( object sender, StartupEventArgs e)
{
MainWindow win = new WPFDemo.MainWindow();
win.Title = "通过OnStartup事件启动的主窗口" ;
win.Show();
Window2 win2 = new Window2();
win2.Title = "通过OnStartup时间启动的第二个窗口" ;
win.Show();
}
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
//重载OnActivated事件,在窗体被激活时触发。
protected override void OnActivated(EventArgs e)
{
System.Diagnostics.Debug.Write( "当前应用程序被激活" );
foreach (Window win in Windows)
{
if (win.IsActive)
{
System.Diagnostics.Debug.WriteLine( "当前的活动窗口是:" + win.Title);
}
}
base .OnActivated(e);
}
|
1 2 3 4 5 6 |
//重载OnDeactivated事件,在窗体被取消激活时触发。
protected override void OnDeactivated(EventArgs e)
{
base .OnDeactivated(e);
System.Diagnostics.Debug.WriteLine( "当前应用程序停止激活" );
}
|
DispatherUnhandledException事件
DispatcherUnhandledException 给开发人员一个处理应用程序为处理的异常的地方。在window1.xaml.cs 的构造函数中抛出一个异常。
1 2 3 4 5 |
public Window1()
{
InitializeComponent();
throw new Exception( "演示DispatherUnhandledException的作用,这里抛出一个异常" );
}
|
然后在App.xaml中添加对DispatherUnhandledException属性的赋值,最后在App.xaml.cs中添加一些代码来显示一个自定义的错误窗口。
1 2 3 4 5 6 |
private void Application_DispatcherUnhandledException( object sender, System.Windows.Threading.DispatcherUnhandledExceptionEventArgs e)
{
string err = "异常信息:" + e.Exception.Message.ToString();
MessageBox.Show(err);
e.Handled = true ;
}
|
运行应用程序将会弹出下面对话框
SessionEnding事件 – 注销或关闭系统
当Windows操作系统的会话终止时,则会触发SessionEnding事件。SessionEnding事件有一个SessionEndingCancelEventArgs类型的参数,该参数有一下Cancel布尔属性,当设置为true时,将会取消windows的会话终止行为。除此之外,还可以使用ReasonSessionEnding枚举类型的属性,来检测终止会话的类型,该属性有下面两个值:
1、 Logoff :会话正在结束的原因是用户正在注销。
2、 Shutdown : 会话正在结束的原因是用户正在关闭Windows。
下面演示如何使用SessionEnding事件,当windows应用程序终止时,弹出一个对话框窗口提示用户进行选择。
App.xaml 文件制定SessionEnding事件
1 2 3 4 5 6 7 8 9 10 11 |
<Application x:Class= "WPFDemo.App"
xmlns= "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x= "http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local= "clr-namespace:WPFDemo"
Startup= "Application_Startup"
SessionEnding= "Application_SessionEnding"
>
<Application.Resources>
</Application.Resources>
</Application>
|
在App.xaml.cs文件中添加如下代码
1 2 3 4 5 6 7 8 9 10 |
private void Application_SessionEnding( object sender, SessionEndingCancelEventArgs e)
{
//询问用户是否允许终止会话
string msg = string .Format( "{0} 是否要终止Windows会话?" , e.ReasonSessionEnding);
MessageBoxResult result = MessageBox.Show(msg, "Session Ending" , MessageBoxButton.YesNo);
if (result == MessageBoxResult.No)
{ //如果点击yes,允许终止,否则禁止终止会话
e.Cancel = true ;
}
}
|
运行应用程序,当windows终止会话时,应用程序会弹出如下图的对话框,如果用户点击“取消”按钮,则会取消终止Windows会话。
Exit事件
当应用程序退出时,将触发Exit事件。下面演示应用程序退出时,向用户隔离区写入应用程序日志和应用程序状态。首先在App.xaml代码中添加事件处理器声明
App.xaml文件
<Application x:Class= "WPFDemo.App"
xmlns= "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x= "http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local= "clr-namespace:WPFDemo"
Startup= "Application_Startup" DispatcherUnhandledException= "Application_DispatcherUnhandledException"
SessionEnding= "Application_SessionEnding"
Exit= "Application_Exit"
>
<Application.Resources>
</Application.Resources>
</Application>
|
在App.xaml.cs文件中添加如下代码
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 |
/// <summary>
/// 应用程序退出标志
/// </summary>
public enum ApplicationExitCode
{
Success = 0,
Failure = 1,
CantWriteToApplicationLog = 2,
CantPersistApplicationState = 3
}
/// <summary>
/// 应用程序退出
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void Application_Exit( object sender, ExitEventArgs e)
{
try
{
if (e.ApplicationExitCode == ( int )ApplicationExitCode.Success)
{
WriteApplicationLogEntry( "Failure" , e.ApplicationExitCode);
}
else
{
WriteApplicationLogEntry( "Success" , e.ApplicationExitCode);
}
}
catch
{
//写入应用程序失败时,更新退出代码已反映出写入失败
e.ApplicationExitCode = ( int )ApplicationExitCode.CantWriteToApplicationLog;
}
//保存应用程序状态
try
{
PersistApplicationState();
}
catch
{
//写入应用程序失败时,更新退出代码已反映出写入失败
e.ApplicationExitCode = ( int )ApplicationExitCode.CantPersistApplicationState;
}
}
/// <summary>
/// 记录应用程序日志
/// </summary>
/// <param name="message"></param>
/// <param name="exitCode"></param>
private void WriteApplicationLogEntry( string message, int exitCode)
{
//写入日志项到用户隔离存储区
IsolatedStorageFile store = IsolatedStorageFile.GetUserStoreForAssembly();
using (Stream stream = new IsolatedStorageFileStream( "log.txt" , FileMode.Append, FileAccess.Write, store))
{
using (StreamWriter writer = new StreamWriter(stream))
{
string entry = string .Format( "{0}:{1} - {2}" , message, exitCode, DateTime.Now);
writer.WriteLine(entry);
}
}
}
/// <summary>
/// 记录应用程序状态日志
/// </summary>
private void PersistApplicationState()
{
//保存应用程序状态到用户隔离存储区
IsolatedStorageFile store = IsolatedStorageFile.GetUserStoreForAssembly();
using (Stream stream = new IsolatedStorageFileStream( "state.txt" , FileMode.Create, store))
using (StreamWriter writer = new StreamWriter(stream))
{
//可以在这里更改为自定义的保存应用程序状态的程序代码
foreach (DictionaryEntry entry in this .Properties)
{
writer.WriteLine(entry.Value);
}
}
}
|
上面代码中,首先定义一个推出的枚举类型。在应用程序Exit事件触发,根据不同的推出写入不同的信息到用户的隔离存储区。通常在Exit事件中保存应用程序的配置信息,当应用程序启动时可以在Startup加载配置信息。
Application类的任务
处理命令行参数
在WPF应用程序中,可以使用两种方法来处理命令行参数。一种是通过Environment对象的静态GetCommandLineArgs方法,另一种是通过相应Application类的Startup事件。该事件提供了SartupEventArgs类型的参数,该参数中包含了从命令行提示符或桌面传递的命令行参数。
使用Startup中 StartupEventArgs获取命令行参数
在App.xaml中指定Startup=”Application_Startup”事件,并在App.xaml.cs Startup事件中添加下列代码
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
private void Application_Startup( object sender, StartupEventArgs e)
{
//该bool值将从命令行参数中获取。如果制定了特定的命令行参数,则将该bool值设置为true;
bool startMinimized = false ;
//命令行参数是一个字符串数组类型,遍历参数数组,寻找特定的命令行参数。
for ( int i = 0; i < e.Args.Length; i++)
{
if (e.Args[i] == "/StartMinimized" )
{
startMinimized = true ;
}
}
//创建应用程序主窗口,如果指定了命令行参数,则最小化运行应用程序。并在窗口显示第一个命令行参数。
Window1 win = new Window1();
if (startMinimized)
{
win.WindowState = WindowState.Minimized;
win.Content = "当前命令行参数" + e.Args[0];
}
win.Show();
}
|
下面在项目中设置命令行参数来调试应用程序。首先在项目名称点击【右键】选择【属性】【调试】然后再命令行参数设置/StartMinimized。(如下图)然后启动应用程序发现应用程序以最小化方式运行,并且在窗体中显示“当前命令行参数/StartMinimized”
也可以使用CMD命令加参数的方式启动应用程序(如下图):
1、 打开CMD命令窗口。
2、 使用cd命令进入应用程序所在的文件夹。 命令: cd 目录名称
3、 然后执行exe应用程序,并指定参数。命令:WPFDemo.exe /StartMinimized
使用Environment的GetCommandLineArgs方法获取命令行参数
只需要将上面代码中获取参数部分替换为
string[] args = Environment.GetCommandLineArgs();
完整代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
private void Application_Startup( object sender, StartupEventArgs e)
{
//该bool值将从命令行参数中获取。如果制定了特定的命令行参数,则将该bool值设置为true;
bool startMinimized = false ;
///使用Environment的GetCommandLineArgs方法获取命令行参数
string [] args = Environment.GetCommandLineArgs();
//命令行参数是一个字符串数组类型,遍历参数数组,寻找特定的命令行参数。
foreach ( string arge in args)
{
if (arge == "/StartMinimized" )
{
startMinimized = true ;
}
}
//创建应用程序主窗口,如果指定了命令行参数,则最小化运行应用程序。并在窗口显示第一个命令行参数。
Window2 win = new Window2();
if (startMinimized)
{
win.WindowState = WindowState.Minimized;
win.Content = "当前命令行参数" + e.Args[0];
}
win.Show();
}
|
单实例应用程序
一个WPF应用程序可以被打开多次,并产生多个进程。在很多场景下只能允许运行一个应用程序。下面提供两种方式创建单实例的应用程序
1、 使用System.Threading命名空间中的Mutex,称为同步基元或者互斥元。
2、 使用windowsFormsApplicationBase类实现单实例应用程序。
使用System.Threading命名空间的Mutex创建单实例应用程序。
1、 引用System.Threading命名空间,定义Mutex对象。
2、 重载Startup方法
3、 运行两个WPF应用程序会弹出“已存在一个应用程序实例”对话框,并关闭当前应用程序。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
Mutex mutex;
protected override void OnStartup(StartupEventArgs e)
{
base .OnStartup(e);
string mutexName = "WPFDemo" ;
bool CreatedNew;
mutex = new Mutex( true , mutexName, out CreatedNew);
if (!CreatedNew) //如果有存在的实例,则关闭当前实例
{
MessageBox.Show( "已存在一个应用程序实例" );
Shutdown();
}
}
|
使用windowsFormsApplicationBase实现单实例应用程序。
1、 添加Microsoft.VisualBasic.dll程序集的引用。
2、 新建SingleApplicationBase类,并添加
Microsoft.VisualBasic 和 Microsoft.VisualBasic.ApplicationServices命名空间。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
//添加命名空间
using Microsoft.VisualBasic;
using Microsoft.VisualBasic.ApplicationServices;
namespace SingleInstanceWithCommunication
{
public class SingleApplicationBase : WindowsFormsApplicationBase
{
public SingleApplicationBase()
{
this .IsSingleInstance = true ; //设置为允许单例模式
}
private App wpfApp;
protected override bool OnStartup(StartupEventArgs eventArgs)
{
wpfApp = new App();
wpfApp.Run();
return false ;
}
//当有其他应用程序实例化时,则出发此事件,将WPF应用程序中显示一个新的窗口
protected override void OnStartupNextInstance(StartupNextInstanceEventArgs eventArgs)
{
base .OnStartupNextInstance(eventArgs);
Console.WriteLine( "启动实例" );
}
}
}
|
3、 右键选择App.xaml页面的属性,更改生成操作位Page。
4、 然后再App.xaml.cs中添加代码。重载Onstartup事件,设置启动页面,然后创建应用程序启动的Main方法。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
protected override void OnStartup(StartupEventArgs e)
{
base .OnStartup(e);
MainWindow win = new SingleInstanceWithCommunication.MainWindow();
this .MainWindow = win;
win.Show();
}
[STAThread]
public static void Main( string [] args)
{
SingleApplicationBase sab = new SingleApplicationBase();
sab.Run(args);
}
|
5、多次启动应用程序,发现同时只能运行一个实例。