ConfigFile

public ConfigFile();

Создаёт пустое хранилище секций, ключей и Variant в памяти. Сам по себе не открывает файл и не загружает прежние данные.

public void Clear();

Удаляет все секции и значения только из памяти этого экземпляра. Не удаляет файл и не сохраняет изменение на диск.

public string EncodeToText();

Создаёт текстовое представление текущих значений без записи файла. Комментарии и исходное форматирование не сохраняются. Не обещает побайтового совпадения с Save: в текущем движке имя секции a]b здесь записывается как [a]b], тогда как Save экранирует закрывающую скобку. Для файлов с такими именами используйте Save.

public void EraseSection(string section);

Удаляет секцию вместе со всеми ключами в памяти. Для отсутствующей секции сообщает native-ошибку, а не гарантированное исключение CLR. Сначала используйте HasSection, если отсутствие допустимо. Файл на диске не изменяется.

public void EraseSectionKey(string section, string key);

Удаляет ключ из секции в памяти. Если ключ был последним, удаляется и секция. Отсутствующие секция или ключ вызывают native-ошибку; для безопасного условного удаления сначала проверяйте HasSectionKey. На диск изменение записывается отдельным Save.

public string[] GetSectionKeys(string section);

Возвращает имена ключей существующей секции. Для отсутствующей секции сообщает native-ошибку и возвращает пустой массив. Проверяйте HasSection, чтобы отличать допустимое отсутствие без сообщения об ошибке.

public string[] GetSections();

Возвращает массив имён секций текущего экземпляра. Это не список файлов и не значения секций. Не привязывайте логику формата сохранения к позиции имени в массиве.

public Variant GetValue(string section, string key, Variant @default = default);

Возвращает значение указанного ключа. Если секция или ключ отсутствуют, возвращает переданный default. При отсутствующем значении и default типа Nil движок также сообщает об ошибке; это не замена явной проверке наличия ключа.

public bool HasSection(string section);

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

public bool HasSectionKey(string section, string key);

Проверяет наличие пары секция/ключ в памяти. При отсутствующей секции возвращает false без ошибки. Тип и диапазон значения проверяйте отдельно после GetValue.

public Error Load(string path);

Читает и разбирает файл в текущий ConfigFile. Одноимённые значения заменяются, а отсутствующие в файле существующие значения остаются: Load не очищает объект. Для полной замены используйте новый ConfigFile или Clear() перед загрузкой. Проверяйте возвращённый Error.

public Error LoadEncrypted(string path, byte[] key);

Открывает шифрованный файл с указанным 32-байтным ключом, затем разбирает значения в текущий экземпляр. Как Load, объединяет данные, не очищая старые. Неверный ключ, повреждённый файл или ошибка разбора не означают успешную загрузку: проверяйте Error и применяйте данные из нового объекта только после валидации.

public Error LoadEncrypted(string path, ReadOnlySpan<byte> key);

Открывает шифрованный файл с указанным 32-байтным ключом, затем разбирает значения в текущий экземпляр. Как Load, объединяет данные, не очищая старые. Неверный ключ, повреждённый файл или ошибка разбора не означают успешную загрузку: проверяйте Error и применяйте данные из нового объекта только после валидации.

public Error LoadEncryptedPass(string path, string password);

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

public Error Parse(string data);

Разбирает текст и добавляет значения в текущий экземпляр, заменяя совпавшие ключи. Не очищает прежние данные. Изменяет объект по ходу разбора: ошибка не гарантирует откат уже прочитанных значений. Для независимой загрузки разбирайте в новом ConfigFile и проверяйте Error до применения данных к игре.

public Error Save(string path);

Записывает текущие значения ConfigFile в файл с INI-подобной структурой. SetValue меняет только память; для записи нужен отдельный Save. Метод не создаёт отсутствующие родительские каталоги.

public Error SaveEncrypted(string path, byte[] key);

Записывает текущие значения в файл с шифрованием AES-256 и указанным 32-байтным ключом. Не создаёт родительские папки и не выполняет атомарную замену с резервной копией. Ошибка не гарантирует сохранность прежнего файла: открытие на запись происходит до завершения операции.

public Error SaveEncrypted(string path, ReadOnlySpan<byte> key);

Записывает текущие значения в файл с шифрованием AES-256 и указанным 32-байтным ключом. Не создаёт родительские папки и не выполняет атомарную замену с резервной копией. Ошибка не гарантирует сохранность прежнего файла: открытие на запись происходит до завершения операции.

public Error SaveEncryptedPass(string path, string password);

Сохраняет значения с шифрованием и ключом, полученным из пароля встроенным алгоритмом. Это другой способ задания ключа, чем 32 байта в SaveEncrypted. Не выполняет резервное копирование или атомарную замену существующего файла.

public void SetValue(string section, string key, Variant value);

Назначает значение в памяти, создавая при необходимости секцию и ключ. Значение Nil, в том числе default(Variant), удаляет ключ; опустевшая секция также удаляется. Сам файл не изменяется до Save.