Files
mirror-processhacker/1.x/trunk/ProcessHacker.Common/Settings/ISettingsStore.cs
T
wj32 7bd28e4357 moved branches, tags, trunk to 1.x branch
git-svn-id: svn://svn.code.sf.net/p/processhacker/code@2304 21ef857c-d57f-4fe0-8362-d861dc6d29cd
2009-10-25 02:22:46 +00:00

63 lines
2.2 KiB
C#

/*
* Process Hacker -
* settings store interface
*
* Copyright (C) 2009 wj32
*
* This file is part of Process Hacker.
*
* Process Hacker is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Process Hacker is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with Process Hacker. If not, see <http://www.gnu.org/licenses/>.
*/
namespace ProcessHacker.Common.Settings
{
/// <summary>
/// Provides an interface for saving settings to persistent storage.
/// </summary>
public interface ISettingsStore
{
/// <summary>
/// Flushes persistent storage.
/// </summary>
void Flush();
/// <summary>
/// Gets a setting value from persistent storage.
/// </summary>
/// <param name="name">The case-sensitive name of the setting.</param>
/// <returns>A string if a value was found for the setting, otherwise null.</returns>
string GetValue(string name);
/// <summary>
/// Resets the persistent storage, deleting all stored values.
/// </summary>
/// <remarks>
/// This usually means deleting the settings file. A flush operation
/// is also assumed to be performed.
/// </remarks>
void Reset();
/// <summary>
/// Saves a setting value into persistent storage.
/// </summary>
/// <param name="name">The case-sensitive name of the setting.</param>
/// <param name="value">The new value of the setting.</param>
/// <remarks>
/// The <paramref name="value"/> string must not be null
/// (but can be empty).
/// </remarks>
void SetValue(string name, string value);
}
}