FileOpenPicker.SettingsIdentifier Property

Definition

Namespace:

Windows.Storage.Pickers

Gets or sets the settings identifier associated with the state of the file open picker.

public:
 property Platform::String ^ SettingsIdentifier { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring SettingsIdentifier();

void SettingsIdentifier(winrt::hstring value);

public string SettingsIdentifier { get; set; }

var string = fileOpenPicker.settingsIdentifier;
fileOpenPicker.settingsIdentifier = string;

Public Property SettingsIdentifier As String

Property Value

String

Platform::String

winrt::hstring

The settings identifier.

Remarks

If your application uses multiple instances of the file open picker, you can use this property to identify the individual instances.

To give the user a sense of consistency, the file open picker remembers the last location that the user navigated to and will generally start at that location. Normally, this remembered location is shared by all file open pickers used by the app. To remember a different location for different pickers, choose a different SettingsIdentifier for each picker.

For example, if you use one file open picker for picking flowers, and another for picking fruit, you can set the SettingsIdentifier for the first picker to "Flowers" and the SettingsIdentifier for the second picker to "Fruit". That way, each time the user picks flowers, they default to the last location they used for picking flowers; and each time the user picks fruit, they default to the last location they used for picking fruit.