FileSavePickerUI.TrySetFileName(String) Method

Reference

Definition

Namespace:: Windows.Storage.Pickers.Provider

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Tries to set the file name and extension in the file picker UI.

public:
 virtual SetFileNameResult TrySetFileName(Platform::String ^ value) = TrySetFileName;

SetFileNameResult TrySetFileName(winrt::hstring const& value);

public SetFileNameResult TrySetFileName(string value);

function trySetFileName(value)

Public Function TrySetFileName (value As String) As SetFileNameResult

Parameters

value: String
Platform::String

winrt::hstring

The file name and extension that are used to update the file name text box and file type drop-down menu in the file picker UI.

Returns

SetFileNameResult

The enumeration value that indicates whether the file name and extension were updated in the file picker UI.

Remarks

As the provider of a save location, your app should call this method when the user selects a file that is displayed on your app page (which is hosted in the file picker).

This method fails if:

The extension specified for the file in value isn't one of the AllowedFileTypes.
The file picker UI isn't visible to the user.
The user is interacting with the file name text box in the file picker UI.

Applies to

Jaa