Лучшая практика сохранения настроек приложения в приложении Windows Forms

533

То, что я хочу достичь, очень просто: у меня есть приложение Windows Forms (.NET 3.5), которое использует путь для чтения информации. Этот путь может быть изменен пользователем, используя форму, которую я предоставляю.

Теперь я хочу сохранить значение пути в файл для последующего использования. Это будет одна из многих настроек, сохраненных в этом файле. Этот файл будет находиться непосредственно в папке приложения.

Я понимаю, что доступны три варианта:

  • Файл ConfigurationSettings (appname.exe.config)
  • Реестр
  • Пользовательский файл XML

Я читал, что конфигурационный файл .NET не предусмотрен для сохранения значений. Что касается реестра, я хотел бы получить как можно дальше от него.

Означает ли это, что я должен использовать собственный файл XML для сохранения настроек конфигурации? Если это так, я хотел бы увидеть пример кода (С#).

Я видел другие дискуссии по этому вопросу, но мне все еще не ясно.

  • 0
    Это приложение .NET WinForms? Если да, то на какой версии .NET вы разрабатываете?
  • 1
    Да, это приложение .NET Framework версии 3.5 WinForms.
Показать ещё 2 комментария
Теги:
winforms
configuration-files
application-settings

13 ответов

555
Лучший ответ

Если вы работаете с Visual Studio, довольно легко получить устойчивые настройки. Щелкните правой кнопкой мыши по проекту в обозревателе решений, выберите "Свойства". Перейдите на вкладку "Настройки", нажмите гиперссылку, если настройки не существуют. Используйте вкладку "Настройки", чтобы создать настройки приложения. Visual Studio создает файлы Settings.settings и Settings.Designer.settings, которые содержат одноэлементный класс Settings, унаследованный от ApplicationSettingsBase. Вы можете получить доступ к этому классу из своего кода для чтения/записи настроек приложения:

Properties.Settings.Default["SomeProperty"] = "Some Value";
Properties.Settings.Default.Save(); // Saves settings in application configuration file

Этот метод применим как для консоли, так и для Windows Forms и других типов проектов.

Обратите внимание, что вам необходимо установить свойство области ваших настроек. Если вы выберете область приложения, то Settings.Default. < ваше свойство > будет доступно только для чтения.

  • 2
    если у меня есть решение, будет ли это применяться ко всему решению или к каждому проекту?
  • 2
    По умолчанию метод Settings.Default.Save() ничего не делает. Вы должны использовать другого провайдера. Смотрите: geek-republic.com/2010/11/08/c-portable-settings-provider
Показать ещё 16 комментариев
86

Если вы планируете сохранить файл в том же каталоге, что и ваш исполняемый файл, вот хорошее решение, которое использует формат JSON

using System;
using System.IO;
using System.Web.Script.Serialization;

namespace MiscConsole
{
    class Program
    {
        static void Main(string[] args)
        {
            MySettings settings = MySettings.Load();
            Console.WriteLine("Current value of 'myInteger': " + settings.myInteger);
            Console.WriteLine("Incrementing 'myInteger'...");
            settings.myInteger++;
            Console.WriteLine("Saving settings...");
            settings.Save();
            Console.WriteLine("Done.");
            Console.ReadKey();
        }

        class MySettings : AppSettings<MySettings>
        {
            public string myString = "Hello World";
            public int myInteger = 1;
        }
    }

    public class AppSettings<T> where T : new()
    {
        private const string DEFAULT_FILENAME = "settings.json";

        public void Save(string fileName = DEFAULT_FILENAME)
        {
            File.WriteAllText(fileName, (new JavaScriptSerializer()).Serialize(this));
        }

        public static void Save(T pSettings, string fileName = DEFAULT_FILENAME)
        {
            File.WriteAllText(fileName, (new JavaScriptSerializer()).Serialize(pSettings));
        }

        public static T Load(string fileName = DEFAULT_FILENAME)
        {
            T t = new T();
            if(File.Exists(fileName))
                t = (new JavaScriptSerializer()).Deserialize<T>(File.ReadAllText(fileName));
            return t;
        }
    }
}
  • 0
    Да, измените DEFAULT_FILENAME на абсолютный путь, если вы хотите сохранить в другой каталог. Я думаю, что наиболее распространенным является сохранение файла в том же каталоге, что и приложение, или подкаталог, если вы не сохраняете их в реестре.
  • 0
    О, возможно, лучшим вариантом было бы сохранить файл настроек в папке appdata пользователя.
Показать ещё 5 комментариев
66

Реестр не работает. Вы не уверены, имеет ли пользователь, который использует ваше приложение, достаточные права на запись в реестр.

Вы можете использовать файл app.config для сохранения настроек уровня приложения (одинаковых для каждого пользователя, использующего ваше приложение).

Я бы сохранил пользовательские настройки в файле XML, который будет сохранен в изолированное хранилище или в каталог SpecialFolder.ApplicationData.

Рядом с этим, как и с .NET 2.0, можно сохранить значения обратно в файл app.config.

  • 8
    Используйте реестр, однако, если вы хотите индивидуальные настройки входа / пользователя.
  • 19
    Реестр не переносим
Показать ещё 8 комментариев
19

Класс ApplicationSettings не поддерживает сохранение настроек в файле app.config. Это очень по дизайну приложения, которые работают с правильно защищенной учетной записью пользователя (думаю, Vista UAC), не имеют права на запись в папку установки программы.

Вы можете сражаться с системой с классом ConfigurationManager. Но тривиальное обходное решение заключается в том, чтобы войти в конструктор настроек и изменить область настройки для пользователя. Если это вызывает трудности (скажем, настройка относится к каждому пользователю), вы должны поместить функцию "Параметры" в отдельную программу, чтобы вы могли запросить приглашение на повышение привилегий. Или не используйте настройку.

  • 0
    Не могли бы вы рассказать о вашем последнем предложении? Попросите повышение прав, чтобы написать app.config или написать отдельное приложение, которое будет проходить через домашние программы всех пользователей, искать user.config и редактировать их?
  • 2
    Отдельная программа требует манифеста, чтобы попросить повышения. Google 'asinvoker требует администратора', чтобы найти правильный синтаксис. Редактирование user.config не является ни практичным, ни необходимым.
14

Я хотел поделиться библиотекой, которую я построил для этого. Это крошечная библиотека, но большое улучшение (IMHO) по сравнению с файлами .settings.

Библиотека называется Jot (GitHub), вот старая статья The Code Project, которую я написал об этом.

Вот как вы можете использовать его для отслеживания размера и местоположения окна:

public MainWindow()
{
    InitializeComponent();

    _stateTracker.Configure(this)
        .IdentifyAs("MyMainWindow")
        .AddProperties(nameof(Height), nameof(Width), nameof(Left), nameof(Top), nameof(WindowState))
        .RegisterPersistTrigger(nameof(Closed))
        .Apply();
}

Преимущество по сравнению с файлами .settings: кода значительно меньше, и он намного менее подвержен ошибкам, поскольку вам нужно упомянуть каждое свойство только один раз.

В файлах настроек вам нужно упоминать каждое свойство пять раз: один раз, когда вы явно создаете свойство, и еще четыре раза в коде, который копирует значения туда и обратно.

Хранение, сериализация и т.д. Полностью настраиваются. Когда целевые объекты создаются контейнером IOC, вы можете [подключить его] [], чтобы он автоматически применял отслеживание ко всем объектам, которые он разрешает, и все, что вам нужно сделать, чтобы сделать свойство постоянным, - добавить атрибут [Trackable] в теме.

Лично я думаю, что библиотека на высшем уровне :)

13

Аргумент registry/configurationSettings/XML по-прежнему кажется очень активным. Я использовал их все, так как технология прогрессировала, но мой фаворит основан на Threed system в сочетании с Изолированное хранилище.

Следующий пример позволяет хранить объекты с именем properties в файле в изолированном хранилище. Например:

AppSettings.Save(myobject, "Prop1,Prop2", "myFile.jsn");

Свойства могут быть восстановлены с использованием:

AppSettings.Load(myobject, "myFile.jsn");

Это всего лишь образец, не наводящий на размышления о лучших практиках.

internal static class AppSettings
{
    internal static void Save(object src, string targ, string fileName)
    {
        Dictionary<string, object> items = new Dictionary<string, object>();
        Type type = src.GetType();

        string[] paramList = targ.Split(new char[] { ',' });
        foreach (string paramName in paramList)
            items.Add(paramName, type.GetProperty(paramName.Trim()).GetValue(src, null));

        try
        {
            // GetUserStoreForApplication doesn't work - can't identify.
            // application unless published by ClickOnce or Silverlight
            IsolatedStorageFile storage = IsolatedStorageFile.GetUserStoreForAssembly();
            using (IsolatedStorageFileStream stream = new IsolatedStorageFileStream(fileName, FileMode.Create, storage))
            using (StreamWriter writer = new StreamWriter(stream))
            {
                writer.Write((new JavaScriptSerializer()).Serialize(items));
            }

        }
        catch (Exception) { }   // If fails - just don't use preferences
    }

    internal static void Load(object tar, string fileName)
    {
        Dictionary<string, object> items = new Dictionary<string, object>();
        Type type = tar.GetType();

        try
        {
            // GetUserStoreForApplication doesn't work - can't identify
            // application unless published by ClickOnce or Silverlight
            IsolatedStorageFile storage = IsolatedStorageFile.GetUserStoreForAssembly();
            using (IsolatedStorageFileStream stream = new IsolatedStorageFileStream(fileName, FileMode.Open, storage))
            using (StreamReader reader = new StreamReader(stream))
            {
                items = (new JavaScriptSerializer()).Deserialize<Dictionary<string, object>>(reader.ReadToEnd());
            }
        }
        catch (Exception) { return; }   // If fails - just don't use preferences.

        foreach (KeyValuePair<string, object> obj in items)
        {
            try
            {
                tar.GetType().GetProperty(obj.Key).SetValue(tar, obj.Value, null);
            }
            catch (Exception) { }
        }
    }
}
  • 1
    Или еще лучше; использовать DataContractJsonSerializer
10

Простым способом является использование объекта данных конфигурации, сохранение его как файла XML с именем приложения в локальной папке и при запуске его прочитать.

Вот пример сохранения позиции и размера формы.

Объект данных конфигурации строго типизирован и прост в использовании:

[Serializable()]
public class CConfigDO
{
    private System.Drawing.Point m_oStartPos;
    private System.Drawing.Size m_oStartSize;

    public System.Drawing.Point StartPos
    {
        get { return m_oStartPos; }
        set { m_oStartPos = value; }
    }

    public System.Drawing.Size StartSize
    {
        get { return m_oStartSize; }
        set { m_oStartSize = value; }
    }
}

Класс менеджера для сохранения и загрузки:

public class CConfigMng
{
    private string m_sConfigFileName = System.IO.Path.GetFileNameWithoutExtension(System.Windows.Forms.Application.ExecutablePath) + ".xml";
    private CConfigDO m_oConfig = new CConfigDO();

    public CConfigDO Config
    {
        get { return m_oConfig; }
        set { m_oConfig = value; }
    }

    // Load configuration file
    public void LoadConfig()
    {
        if (System.IO.File.Exists(m_sConfigFileName))
        {
            System.IO.StreamReader srReader = System.IO.File.OpenText(m_sConfigFileName);
            Type tType = m_oConfig.GetType();
            System.Xml.Serialization.XmlSerializer xsSerializer = new System.Xml.Serialization.XmlSerializer(tType);
            object oData = xsSerializer.Deserialize(srReader);
            m_oConfig = (CConfigDO)oData;
            srReader.Close();
        }
    }

    // Save configuration file
    public void SaveConfig()
    {
        System.IO.StreamWriter swWriter = System.IO.File.CreateText(m_sConfigFileName);
        Type tType = m_oConfig.GetType();
        if (tType.IsSerializable)
        {
            System.Xml.Serialization.XmlSerializer xsSerializer = new System.Xml.Serialization.XmlSerializer(tType);
            xsSerializer.Serialize(swWriter, m_oConfig);
            swWriter.Close();
        }
    }
}

Теперь вы можете создать экземпляр и использовать в своей форме загрузку и закрытие событий:

    private CConfigMng oConfigMng = new CConfigMng();

    private void Form1_Load(object sender, EventArgs e)
    {
        // Load configuration
        oConfigMng.LoadConfig();
        if (oConfigMng.Config.StartPos.X != 0 || oConfigMng.Config.StartPos.Y != 0)
        {
            Location = oConfigMng.Config.StartPos;
            Size = oConfigMng.Config.StartSize;
        }
    }

    private void Form1_FormClosed(object sender, FormClosedEventArgs e)
    {
        // Save configuration
        oConfigMng.Config.StartPos = Location;
        oConfigMng.Config.StartSize = Size;
        oConfigMng.SaveConfig();
    }

И полученный XML файл также можно прочитать:

<?xml version="1.0" encoding="utf-8"?>
<CConfigDO xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <StartPos>
    <X>70</X>
    <Y>278</Y>
  </StartPos>
  <StartSize>
    <Width>253</Width>
    <Height>229</Height>
  </StartSize>
</CConfigDO>
  • 1
    У меня это отлично работает при разработке, но при развертывании приложения обычный пользователь не имеет доступа к папке c:\program files\my application , поэтому сохранение настроек выдает ошибку. Вместо этого я пытаюсь сохранить XML-файл в AppData, но мне просто интересно, существует ли очевидный способ обойти эту проблему, поскольку этот подход, похоже, сработал для вас.
  • 0
    @PhilipStratford Так как это обычный файл, вы можете сохранить его где угодно. Просто найдите место с доступом для записи.
Показать ещё 2 комментария
6

Мне не нравится предлагаемое решение использования web.config или app.config. Попробуйте прочитать свой собственный XML. Посмотрите Файлы настроек XML - больше нет web.config.

3

Другие параметры, вместо использования пользовательского XML файла, мы можем использовать более удобный формат файла: JSON или YAML.

  • Если вы используете динамику .NET 4.0, эта библиотека очень проста в использовании (сериализация, десериализация, поддержка вложенных объектов и вывод заказов как вы хотите + слияние нескольких настроек с одним) JsonConfig (использование эквивалентно ApplicationSettingsBase)
  • Для библиотеки конфигурации .NET YAML... Я не нашел тот, который есть как простой в использовании как JsonConfig

Вы можете сохранить файл настроек в нескольких специальных папках (для всех пользователей и для каждого пользователя), как указано здесь Environment.SpecialFolder Enumeration и несколько файлы (только для чтения по умолчанию, для каждой роли, для каждого пользователя и т.д.)

Если вы решите использовать несколько параметров, вы можете объединить эти параметры: например, слияние настроек по умолчанию + BasicUser + AdminUser. Вы можете использовать свои собственные правила: последний переопределяет значение и т.д.

2

"Означает ли это, что я должен использовать собственный файл XML для сохранения настроек конфигурации?" Нет, не обязательно. Для таких операций мы используем SharpConfig.

Например, если файл конфигурации подобен этому

[General]
# a comment
SomeString = Hello World!
SomeInteger = 10 # an inline comment

Мы можем получить такие значения, как это

var config = Configuration.LoadFromFile("sample.cfg");
var section = config["General"];

string someString = section["SomeString"].StringValue;
int someInteger = section["SomeInteger"].IntValue;

Он совместим с.Net 2.0 и выше. Мы можем создавать конфигурационные файлы на лету, и мы можем сохранить их позже. Источник: http://sharpconfig.net/ Github: https://github.com/cemdervis/SharpConfig

Я надеюсь, что это помогает.

2

Насколько я могу судить,.NET поддерживает постоянные настройки с помощью встроенного средства настройки приложений:

Функция "Параметры приложения" в Windows Forms упрощает создание, хранение и обслуживание пользовательских приложений и пользовательских настроек на клиентском компьютере. С настройками приложения Windows Forms вы можете хранить не только данные приложения, такие как строки подключения к базе данных, но и данные, специфичные для пользователя, такие как настройки пользовательского приложения. Используя Visual Studio или настраиваемый управляемый код, вы можете создавать новые настройки, читать их и записывать на диск, привязывать их к свойствам в своих формах и проверять данные настроек до загрузки и сохранения.  - http://msdn.microsoft.com/en-us/library/k4s6c3a0.aspx

  • 2
    Не правда .. см. Ответ аку выше. это возможно с помощью настроек и ApplicationSettingsBase
1

Иногда вы хотите избавиться от этих настроек, хранящихся в традиционном файле web.config или app.config. Вы хотите более мелкомасштабный контроль над развертыванием ваших записей настроек и разделенным дизайном данных. Или необходимо включить добавление новых записей во время выполнения.

Я могу представить два хороших варианта:

  • Сильно типизированная версия и
  • Объектно-ориентированная версия.

Преимущество строго типизированной версии - это строго типизированные имена и значения параметров. Нет риска смешения имен или типов данных. Недостатком является то, что больше настроек должно быть закодировано, не может быть добавлено во время выполнения.

В объектно-ориентированной версии преимущество заключается в том, что во время выполнения могут быть добавлены новые настройки. Но у вас нет строго типизированных имен и значений. Будьте осторожны с строковыми идентификаторами. Должен знать тип данных, сохраненный ранее при получении значения.

Вы можете найти код как полностью функциональных реализаций ЗДЕСЬ.

0
public static class SettingsExtensions
{
    public static bool TryGetValue<T>(this Settings settings, string key, out T value)
    {
        if (settings.Properties[key] != null)
        {
            value = (T) settings[key];
            return true;
        }

        value = default(T);
        return false;
    }

    public static bool ContainsKey(this Settings settings, string key)
    {
        return settings.Properties[key] != null;
    }

    public static void SetValue<T>(this Settings settings, string key, T value)
    {
        if (settings.Properties[key] == null)
        {
            var p = new SettingsProperty(key)
            {
                PropertyType = typeof(T),
                Provider = settings.Providers["LocalFileSettingsProvider"],
                SerializeAs = SettingsSerializeAs.Xml
            };
            p.Attributes.Add(typeof(UserScopedSettingAttribute), new UserScopedSettingAttribute());
            var v = new SettingsPropertyValue(p);
            settings.Properties.Add(p);
            settings.Reload();
        }
        settings[key] = value;
        settings.Save();
    }
}

Ещё вопросы

Сообщество Overcoder
Наверх
Меню