本主题演示如何在保留应用程序设置前先验证它们。
由于应用程序设置是强类型设置,因此在一定程度上可以相信用户无法向给定设置分配错误类型的数据。 但是,用户仍有可能尝试向设置分配超出可接受范围的值,例如,用户提供的出生日期可能是一个将来日期。 xref:System.Configuration.ApplicationSettingsBase所有应用程序设置类的父类公开四个事件,若要启用此类边界检查。 处理这些事件会将所有验证代码放置在同一位置中,而不是将其分散到整个项目。
所用事件取决于需要何时验证设置,如下表所述。
| Event | 发生时间和用法 |
|---|---|
| xref:System.Configuration.ApplicationSettingsBase.SettingsLoaded | 初始加载设置属性组后发生。 在应用程序中使用属性组前,使用此事件验证整个属性组的初始值。 |
| xref:System.Configuration.ApplicationSettingsBase.SettingChanging | 在更改单个设置属性的值之前发生。 更改单个属性之前,使用此事件验证该属性。 它可以向用户提供有关其操作和选择的即时反馈。 |
| xref:System.Configuration.ApplicationSettingsBase.PropertyChanged | 在更改单个设置属性的值之后发生。 更改单个属性之后,使用此事件验证该属性。 除非需要进行长时间的异步验证处理,否则很少将此事件用于验证操作。 |
| xref:System.Configuration.ApplicationSettingsBase.SettingsSaving | 在存储设置属性组之前发生。 将属性组保留到磁盘之前,使用此事件验证整个属性组的值。 |
通常,不会在同一应用程序中使用所有这些事件进行验证操作。 例如,则通常可以通过仅处理满足所有验证需求xref:System.Configuration.ApplicationSettingsBase.SettingChanging事件。
事件处理程序检测到无效值时通常执行以下操作之一:
-
自动提供已知是正确的值,如默认值。
-
再次询问服务器代码用户,以获取信息。
-
如及其关联的操作之前引发的事件xref:System.Configuration.ApplicationSettingsBase.SettingChanging并xref:System.Configuration.ApplicationSettingsBase.SettingsSaving,使用xref:System.ComponentModel.CancelEventArgs参数来取消该操作。
有关事件处理的详细信息,请参阅事件处理程序概述。
以下过程介绍如何测试使用的有效的出生日期xref:System.Configuration.ApplicationSettingsBase.SettingChanging或xref:System.Configuration.ApplicationSettingsBase.SettingsSaving事件。 这些过程是在假定已创建应用程序设置的情况下编写的;在此示例中,我们将对名为 DateOfBirth 的设置执行边界检查。 有关创建设置的详细信息,请参阅如何:创建应用程序设置。
获取应用程序设置对象
-
通过完成以下项目符号项之一,获取对应用程序设置对象(包装器实例)的引用:
-
如果使用“属性编辑器” 中的“Visual Studio 应用程序设置”对话框创建设置,则可通过以下表达式检索为语言生成的默认设置对象。
Configuration.Settings.DefaultMySettings.Default或
-
如果是 Visual Basic 开发人员并使用项目设计器创建应用程序设置,则可通过使用 My.Settings Object 对象来检索设置。
或
-
如果通过从派生来创建你的设置xref:System.Configuration.ApplicationSettingsBase直接,您需要手动实例化类。
MyCustomSettings settings = new MyCustomSettings();Dim Settings as New MyCustomSettings()
-
下列过程的编写依据:假定应用程序设置对象是通过完成本过程中最后一个项目符号项来获取的。
设置更改时验证应用程序设置
-
如果您是C#开发人员,在窗体或控件的
Load事件添加事件处理程序xref:System.Configuration.ApplicationSettingsBase.SettingChanging事件。或
如果是 Visual Basic 开发人员,则应使用
WithEvents关键字声明Settings变量。public void Form1_Load(Object sender, EventArgs e) { settings.SettingChanging += new SettingChangingEventHandler(MyCustomSettings_SettingChanging); }Public Sub Form1_Load(sender as Object, e as EventArgs) AddHandler settings.SettingChanging, AddressOf MyCustomSettings_SettingChanging End Sub -
定义事件处理程序,并在该事件处理程序中编写代码,以便对出生日期执行边界检查。
private void MyCustomSettings_SettingChanging(Object sender, SettingChangingEventArgs e) { if (e.SettingName.Equals("DateOfBirth")) { Date newDate = (Date)e.NewValue; If (newDate > Date.Now) { e.Cancel = true; // Inform the user. } } }Private Sub MyCustomSettings_SettingChanging(sender as Object, e as SettingChangingEventArgs) Handles Settings.SettingChanging If (e.SettingName.Equals("DateOfBirth")) Then Dim NewDate as Date = CType(e.NewValue, Date) If (NewDate > Date.Now) Then e.Cancel = True ' Inform the user. End If End If End Sub
保存时验证应用程序设置
-
在窗体或控件的
Load事件,添加的事件处理程序xref:System.Configuration.ApplicationSettingsBase.SettingsSaving事件。public void Form1_Load(Object sender, EventArgs e) { settings.SettingsSaving += new SettingsSavingEventHandler(MyCustomSettings_SettingsSaving); }Public Sub Form1_Load(Sender as Object, e as EventArgs) AddHandler settings.SettingsSaving, AddressOf MyCustomSettings_SettingsSaving End Sub -
定义事件处理程序,并在该事件处理程序中编写代码,以便对出生日期执行边界检查。
private void MyCustomSettings_SettingsSaving(Object sender, SettingsSavingEventArgs e) { if (this["DateOfBirth"] > Date.Now) { e.Cancel = true; } }Private Sub MyCustomSettings_SettingsSaving(Sender as Object, e as SettingsSavingEventArgs) If (Me["DateOfBirth"] > Date.Now) Then e.Cancel = True End If End Sub
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
