大网数据广告活动
.NET 与 C# 开发

如何:验证应用程序设置

· 52CE 我爱测

由于应用程序设置是强类型设置,因此在一定程度上可以相信用户无法向给定设置分配错误类型的数据。 但是,用户仍有可能尝试向设置分配超出可接受范围的值,例如,用户提供的出生日期可能是一个将来日期。 所有应用程序设置类的父类公开四个事件,若要启用此类边界检查。 处理这些事件会将所有验证代码放置在同一位置中,而不是将其分散到整个项目。

本主题演示如何在保留应用程序设置前先验证它们。

由于应用程序设置是强类型设置,因此在一定程度上可以相信用户无法向给定设置分配错误类型的数据。 但是,用户仍有可能尝试向设置分配超出可接受范围的值,例如,用户提供的出生日期可能是一个将来日期。 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事件。 这些过程是在假定已创建应用程序设置的情况下编写的;在此示例中,我们将对名为 DateOfBirth 的设置执行边界检查。 有关创建设置的详细信息,请参阅如何:创建应用程序设置。

获取应用程序设置对象

  • 通过完成以下项目符号项之一,获取对应用程序设置对象(包装器实例)的引用:

    • 如果使用“属性编辑器” 中的“Visual Studio 应用程序设置”对话框创建设置,则可通过以下表达式检索为语言生成的默认设置对象。

      Configuration.Settings.Default
      
      MySettings.Default
      

      或

    • 如果是 Visual Basic 开发人员并使用项目设计器创建应用程序设置,则可通过使用 My.Settings Object 对象来检索设置。

      或

    • 如果通过从派生来创建你的设置xref:System.Configuration.ApplicationSettingsBase直接,您需要手动实例化类。

      MyCustomSettings settings = new MyCustomSettings();
      
      Dim Settings as New MyCustomSettings()
      

下列过程的编写依据:假定应用程序设置对象是通过完成本过程中最后一个项目符号项来获取的。

设置更改时验证应用程序设置

  1. 如果您是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
    
  2. 定义事件处理程序,并在该事件处理程序中编写代码,以便对出生日期执行边界检查。

    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
    

保存时验证应用程序设置

  1. 在窗体或控件的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
    
  2. 定义事件处理程序,并在该事件处理程序中编写代码,以便对出生日期执行边界检查。

    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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。