settings-codebehind.md

Settings Page (Code Behind)

❗ There is also a version of this document with code samples in VB.Net ❗

By default the settings page contains a single boolean setting to track whether the app should be displayed with the Light or Dark theme.

Add another boolean setting

Add the following below the StackPanel containing the RadioButtons in SettingsView.xaml

<CheckBox IsChecked="{x:Bind IsAutoErrorReportingEnabled, Mode=OneWay}"
          x:Uid="Settings_EnableAutoErrorReporting"
          Checked="CheckBoxChecked"
          Unchecked="CheckBoxUnchecked"
          Margin="0,8,0,0" />

Add an entry to Strings/en-us/Resources.resw

Name: Settings_EnableAutoErrorReporting.Content

Value: Automatically report errors

When run it will now look like this:

But if you try and run it now you will get build errors as the code behind file hasn't been updated to add the new property and event handlers.

Update the code behind file

If using the Blank or NavigationView project types.

In SettingsPage.xaml.cs, change the OnNavigatedTo method to be like this

protected override async void OnNavigatedTo(NavigationEventArgs e)
{
    Initialize();
    IsAutoErrorReportingEnabled = await Windows.Storage.ApplicationData.Current.LocalSettings.ReadAsync<bool>(nameof(IsAutoErrorReportingEnabled));
}

If using the Pivot&Tabs project type.

In SettingsPage.xaml.cs, change the OnLoaded and Initialize methods to be like this

private async void OnLoaded(object sender, RoutedEventArgs e)
{
    await InitializeAsync();
}

private async Task InitializeAsync()
{
    VersionDescription = GetVersionDescription();
    IsAutoErrorReportingEnabled = await Windows.Storage.ApplicationData.Current.LocalSettings.ReadAsync<bool>(nameof(IsAutoErrorReportingEnabled));
}

For all project types, also add the following to SettingsPage.xaml.cs.

using {YourAppName}.Helpers;


private bool _isAutoErrorReportingEnabled;
public bool? IsAutoErrorReportingEnabled
{
    get { return _isAutoErrorReportingEnabled; }
    set { Set(ref _isAutoErrorReportingEnabled, (bool)value); }
}

private async void CheckBoxChecked(object sender, Windows.UI.Xaml.RoutedEventArgs e)
{
        await Windows.Storage.ApplicationData.Current.LocalSettings.SaveAsync(nameof(IsAutoErrorReportingEnabled), true);
}

private async void CheckBoxUnchecked(object sender, Windows.UI.Xaml.RoutedEventArgs e)
{
    await Windows.Storage.ApplicationData.Current.LocalSettings.SaveAsync(nameof(IsAutoErrorReportingEnabled), false);
}

Accessing the setting from elsewhere in the app

If you want to access the property elsewhere in the app, the easiest way to do this is to read the setting directly. The code below reads the value into a variable called isEnabled which you can then query as needed.

var isEnabled = await Helpers.SettingsStorageExtensions.ReadAsync<bool>(Windows.Storage.ApplicationData.Current.LocalSettings, "IsAutoErrorReportingEnabled");