Namespace: Wisej.Web

Assembly: Wisej.Framework (

Displays a dialog box from which the user can select a file.

public class FileDialog : CommonDialog

This class is abstract. The current implementations in Wisej are OpenFileDialog and SaveFileDialog. You can override this class or OpenFileDialog and SaveFileDialog to add your own custom behavior and localization. You can:

  • Override PromptFileNotFound. It's called when the specified file doesn't exist and the property CheckFileExists is true.

  • Override CreateUI to create your custom Form when the method ShowDialog is called.

  • Set the DialogTemplate to a Form class that has a constructor that accepts FileDialog as the single argument to change the User Interface (UI) of the file dialog.

  • Override OnFileOk to provide your custom implementation of the actions to execute when the user presses the OK button.

You must add at least one FileSystemProvider to the Roots collection before showing the dialog.


Initializes a new instance of FileDialog.

Initializes a new instance of FileDialog using the initial roots .



Initial file systems to load in the FolderBrowserDialog.

Initializes a new instance of the FileDialog extender with a specified container.



An IContainer that represents the container of the FileDialog component.


Boolean: Returns or sets whether the dialog box automatically adds an extension to a file name if the user omits the extension. (Default: True)

Boolean: Returns or sets whether the dialog box displays a warning if the user specifies a file name that does not exist. (Default: False)

String: Returns or sets the default file name extension. (Default: "")

String: Returns or sets a string containing the file name selected in the file dialog box. (Default: "")

String[]: Returns the file names of all selected files in the dialog box.

IFileSystemProvider: Returns the IFileSystemProvider that contains the selected FileName.

String: Returns or sets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box. (Default: "")

Int32: Returns or sets the index of the filter currently selected in the file dialog box. (Default: 1)

String: Returns or sets the initial directory displayed by the file dialog box. (Default: "")

FileDialogRootCollection: List of root IFileSystemProvider file systems displayed by the FileDialog.

The Roots collection and the IFileSystemProvider implementations allow the application to use arbitrary names mapped to a specific path. For example, the app may add a root object named "Documents" to "c:\users[logged-user-id]\files\documents". Each user will see "Documents" as the root, but will also see only the files in the [logged-user-id] directory.

Boolean: Returns or sets whether the Help button is displayed in the file dialog box. (Default: False)

String: Returns or sets the file dialog box title. (Default: "")


Returns the IFileSystemProvider that contains the specified path .



Full path of the file to locate in on of the Roots.

Returns: IFileSystemProvider. The IFileSystemProvider that contains the specified path or null if not found.

Maps the virtual path to the corresponding physical path on the specific IFileSystemProvider implementation.



Virtual path to map to the corresponding physical path.

Returns: String. The physical path for the IFileSystemProvider implementation.

Receives the file names selected by the user and validates them according to the properties set in the FileDialog instance.



Array containing the selected file paths.

Returns: Boolean. True if the files have been validated and the dialog can close; otherwise false to keep the dialog open.

Resets all properties to their default values.


CancelEventHandler Fired when the user clicks on the Open or Save button on a file dialog box.

FileDialogLoadPathEventHandler Fired when the file dialog is loading a file or folder.

Inherited By


Prompts the user to open a file from the server.

Prompts the user to select a location for saving a file on the server.

Last updated