管理应用程序设置 (.NET)

通过应用程序设置,可以动态存储应用程序信息。 借助应用程序设置,可以使用客户端计算机来存储运行时不应包含在应用程序代码中的信息。 应用程序设置可以包括连接字符串、用户首选项等。

注意

应用程序设置取代了 Visual Studio 早期版本中使用的动态属性。

每个应用程序设置必须具有唯一的名称。 名称可以是字母、数字或下划线的任意组合。 名称不能以数字开头,并且不能有空格。 可通过 Name 属性来更改名称。

应用程序设置可以存储为可序列化成 XML 或包含用于实现 /ToStringFromStringTypeConverter 的任何数据类型。 最常见的类型有 StringIntegerBoolean。 也可以将值存储为 ColorObject 或连接字符串。

应用程序设置还包含值。 这些值通过 “值” 属性来设置,而且必须与设置的数据类型匹配。

此外,在设计时可将应用程序设置绑定到窗体或控件的属性。

有两类基于范围的应用程序设置:

  • 应用程序范围的设置可以用于诸如 Web 服务的 URL 或数据库连接字符串这类的信息。 这些值是与应用程序关联的。 因此,用户无法在运行时更改它们。

  • 用户范围的设置可以用于诸如保持窗体的最后位置或字体首选项这类的信息。 用户可以在运行时更改这些值。

可以使用 “范围” 属性更改设置类型。

项目系统将应用程序设置存储在两个 XML 文件中:

  • app.config 文件,此文件在创建第一个应用程序设置的设计时创建

  • user.config 文件,此文件是在运行应用程序的用户更改任何用户设置值时在运行时创建的

用户设置中的更改不会写到磁盘,除非应用程序专门调用某一方法这样做。

在设计时创建应用程序设置

在设计时,可以通过两种方式创建应用程序设置:

  • 使用“项目设计器”的“设置”页。

  • 使用窗体或控件的“属性”窗口,这样就可以将设置绑定到属性。

当你创建应用程序范围的设置(例如,数据库连接字符串或对服务器资源的引用)时,Visual Studio 将它与 <applicationSettings> 标记一起保存在 app.config 文件中。 连接字符串保存在 <connectionStrings> 标记下。

当你创建用户范围的设置(例如默认字体、主页或窗口大小)时,Visual Studio 将它与 <userSettings> 标记一起保存在 app.config 文件中。

重要

当你将连接字符串存储在 app.config 中时,应该采取预防措施以避免泄露连接字符串中的敏感信息(如密码或服务器路径)

如果从外部源获取连接字符串信息(如提供用户 ID 和密码的用户),请确保用于构造连接字符串的值不包含更改连接行为的附加连接字符串参数。

可考虑使用“受保护的配置”功能以加密配置文件中的敏感信息。 有关详细信息,请参阅保护连接信息

注意

由于没有类库的配置文件模型,应用程序设置不适用于类库项目。 Visual Studio Tools for Office 运行时 DLL 项目是一个例外,它可以有一个配置文件。

使用自定义设置文件

可以将自定义的设置文件添加到项目中,以方便进行设置组的管理。 单个文件中包含的设置会作为一个单元进行加载和保存。 将常用组和不常用组的设置分别存储在单独的文件中,可以节省加载和保存设置的时间。

例如,可以将 SpecialSettings.settings 文件添加到项目中。 虽然 SpecialSettings 类未在 My 命名空间中公开,但可以使用“查看代码”读取包含 Partial Class SpecialSettings 的自定义设置文件。

“设置设计器”首先搜索项目系统创建的 Settings.settings 文件。 Settings.settings 文件是“项目设计器”在“设置”选项卡中显示的默认文件。Settings.settings 文件位于 Visual Basic 项目的“My Project”文件夹和 Visual C# 项目的“Properties”文件夹中。 然后,“项目设计器”在项目的根文件夹中搜索其他设置文件。 因此,你应当将自定义的设置文件放在此根文件夹中。 如果将 .settings 文件添加到项目中的其他地方,则项目设计器无法找到此文件。

在运行时访问或更改 Visual Basic 应用程序的设置

在 Visual Basic 项目中,可使用 My.Settings 对象在运行时访问应用程序设置。 在“设置”页上,选择“查看代码”按钮以查看 Settings.vb 文件。 Settings.vb 定义 Settings 类,此类使你能够处理设置类上的以下事件:

Settings.vb 中的 Settings 类是分部类,它仅显示用户拥有的代码,而不显示整个生成的类。 有关使用 My.Settings 对象访问应用程序设置的详细信息,请参阅访问应用程序设置 (.NET Framework)

用户在运行时更改的任何用户范围设置的值(例如,窗体的位置)都存储在 user.config 文件中。 默认值仍保存在 app.config 中。

如果在运行时期间(例如,在测试应用程序过程中)已更改任何用户范围的设置,并要将这些设置重置为默认值,请选择“同步”按钮。

建议使用 My.Settings 对象和默认 .settings 文件来访问设置。 可以使用“设置设计器”为设置分配属性,此外,还将在应用程序关闭之前自动保存用户设置。 但是,Visual Basic 应用程序可以直接访问设置。 在这种情况下,你必须访问 MySettings 类并使用项目根目录中的自定义 .settings 文件。 与处理 C# 应用程序时一样,在结束应用程序之前必须保存用户设置,如下一节所述。

在运行时访问或更改 C# 应用程序的设置

在 Visual Basic 以外的语言(如 C#)中,必须直接访问 Settings 类,如下面的 Visual C# 示例中所示。

Properties.Settings.Default.FirstUserSetting = "abc";

必须显式调用此包装类的 Save 方法,才能持久地保存用户设置。 此操作通常在主窗体的 Closing 事件处理程序中完成。 下面的 C# 示例演示对 Save 方法的调用。

Properties.Settings.Default.Save();

有关通过 Settings 类访问应用程序设置的常规信息,请参阅应用程序设置概述 (.NET Framework)

将应用从 .NET Framework 迁移到 .NET

.NET Framework 使用 app.config 文件为应用加载设置,例如连接字符串和日志提供程序配置。 现代 .NET 使用 appsettings.json 文件进行应用设置。 若要详细了解如何将 app.config 文件转换为 appsettings.json,请参阅从 .NET Framework 升级到 .NET 后进行现代化