如何在 .net 中跨不同程序集版本保留 user.config 设置？

ApplicationSettingsBase 有一个 method called Upgrade，它从以前的版本迁移所有设置。

为了在您发布应用程序的新版本时运行合并，您可以在设置文件中定义一个默认为 true 的布尔标志。将其命名为 UpgradeRequired 或类似名称。

然后，在应用程序启动时检查标志是否已设置，如果已设置，请调用 Upgrade method，将标志设置为 false 并保存您的配置。

if (Settings.Default.UpgradeRequired)
{
    Settings.Default.Upgrade();
    Settings.Default.UpgradeRequired = false;
    Settings.Default.Save();
}

在 MSDN 阅读有关升级方法的更多信息。如果您需要进行一些自定义合并，GetPreviousVersion 也可能值得一看。

---

当我们每个版本只需要升级一次时，下一个简短的解决方案对我有用。它确实不需要像 UpgradeRequired 这样的额外设置：

if (!ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.PerUserRoamingAndLocal).HasFile)
    Settings.Default.Upgrade();

---

我知道已经有一段时间了...在 winforms 应用程序中，只需在加载它们之前调用 My.Settings.Upgrade()。这将获得最新的设置，无论是当前版本还是以前的版本。

---

这是我的研究，以防其他人在迁移已更改/删除的设置时遇到困难。基本问题是，如果您在新版本的应用程序中重命名或删除了设置，GetPreviousVersion() 将不起作用。因此，您需要将设置保留在您的 Settings 类中，但向其添加一些属性/工件，这样您就不会在其他地方的代码中无意中使用它，从而使其过时。 VB.NET 中的示例过时设置如下所示（可以轻松转换为 C#）：

<UserScopedSetting(),
DebuggerNonUserCode(),
DefaultSettingValue(""),
Obsolete("Do not use this property for any purpose. Use YOUR_NEW_SETTING_NAME instead."),
NoSettingsVersionUpgrade()>
Public Property OldSettingName() As String
  Get
    Throw New NotSupportedException("This property is obsolete")
  End Get
  Set
    Throw New NotSupportedException("This property is obsolete")
  End Set
End Property

确保将此属性添加到具有应用程序设置的同一名称空间/类中。在 VB.NET 中，此类名为 MySettings，可在 My 命名空间中使用。您可以使用部分类功能来防止过时的设置与当前设置混淆。

完全感谢 jsharrison 发布有关此问题的 excellent article。您可以在此处阅读有关它的更多详细信息。

---

这是此处介绍的解决方案的一种变体，它将升级逻辑封装到设置类可以从中派生的抽象类中。

一些建议的解决方案使用 DefaultSettingsValue 属性来指定一个值，该值指示何时未加载先前的设置。我的偏好是简单地使用默认值表明这一点的类型。作为奖励，日期时间？是有用的调试信息。

public abstract class UserSettingsBase : ApplicationSettingsBase
{
    public UserSettingsBase() : base()
    {
        // Accessing a property attempts to load the settings for this assembly version
        // If LastSaved has no value (default) an upgrade might be needed
        if (LastSaved == null)
        {
            Upgrade();
        }
    }

    [UserScopedSetting]
    public DateTime? LastSaved
    {
        get { return (DateTime?)this[nameof(LastSaved)]; }
        private set { this[nameof(LastSaved)] = value; }
    }

    public override void Save()
    {
        LastSaved = DateTime.Now;
        base.Save();
    }
}

派生自 UserSettingsBase：

public class MySettings : UserSettingsBase
{
    [UserScopedSetting]
    public string SomeSetting
    {
        get { return (string)this[nameof(SomeSetting)]; }
        set { this[nameof(SomeSetting)] = value; }
    }

    public MySettings() : base() { }
}

并使用它：

// Existing settings are loaded and upgraded if needed
MySettings settings = new MySettings();
...
settings.SomeSetting = "SomeValue";
...
settings.Save();

---

如果您对 user.settings 的更改是以编程方式完成的，那么如何在单独的文件（例如 user.customized.settings）中维护（仅）对 user.settings 的修改的副本？

您可能还想在 user.settings 中维护和加载修改后的设置。但是这样，当您使用更新版本的 user.settings 安装应用程序的更新版本时，您可以通过将修改后的设置复制回新的 user.settings 来询问用户是否要继续使用修改后的设置。您可以批量导入它们，或者更高级地要求用户确认他们想要继续使用哪些设置。

编辑：我在“更准确”的部分上读得太快了关于程序集版本导致新的 user.settings 安装到新版本特定的目录中。因此，上面的想法可能对您没有帮助，但可能会提供一些思考。

---

我是这样处理的：

public virtual void LoadSettings(ServiceFileFormBaseSettings settings = null, bool resetSettingsToDefaults = false)
{
    if (settings == null)
            return;

    if (resetSettingsToDefaults)
        settings.Reset();
    else
    {
        settings.Reload();

        if (settings.IsDefault)
            settings.Upgrade();
    }

    this.Size = settings.FormSize;

}

在设置类中，我定义了 IsDefault 属性：

// SaveSettings always sets this to be FALSE.
// This will have the default value TRUE when first deployed, or immediately after an upgrade.
// When the settings exist, this is false.
//
[UserScopedSettingAttribute()]
[DefaultSettingValueAttribute("true")]
public virtual bool IsDefault
{
    get { return (bool)this["IsDefault"]; }
    set { this["IsDefault"] = value; }
}

在 SaveSettings 中，我将 IsDefault 设置为 false：

public virtual void SaveSettings(ServiceFileFormBaseSettings settings = null)
{
    if (settings == null) // ignore calls from this base form, if any
        return;

    settings.IsDefault = false;
    settings.FormSize = this.Size;
    settings.Save();
}

---