Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
a C# implementation of SettingsProvider for portable applications
C#
tree: 6d2127715d

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src
.gitattributes
.gitignore
LICENCE.md
README.md

README.md

PortableSettingsProvider

PortableSettingsProvider is a C# implementation of SettingsProvider for portable applications.

Usage

  1. Add src/PortableSettingsProvider.cs to your project.

  2. For each setting that should be portable, set the Provider property to the PortableSettingsProvider class, with a namespace qualifier if required. (By default this would be crdx.Settings.PortableSettingsProvider, but feel free to change the namespace and/or class name as you wish.)

  3. Optionally, set the Roaming property to True for global settings, or False for local settings. (See File format below for an explanation.) Visual Studio currently defaults this to False.

  4. Read and write your application settings as you normally would.

File format

The application settings are stored in an XML file in the same directory as the application. The filename is the same as the application's executable, with the file extension settings.

Two types of settings are supported: global (roaming) and local.

Global (aka "Roaming")

Global settings are not tied to the current machine and are available to all running instances of the application, regardless of where it's being run from.

Global settings are stored in the /Settings/GlobalSettings node.

Local

Local settings are tied to the computer on which the application is running, using the computer name as the unique identifier.

Local settings are stored in the /Settings/LocalSettings/[ComputerName] node.

Bugs or contributions

Open an issue or send a pull request.

Licence

MIT.

Something went wrong with that request. Please try again.