Class
FileDialogComponentBase

Definition

Constructors

FileDialogComponentBase()

Declaration

cs-api-definition
public FileDialogComponentBase()

Properties

CustomPlaces

Gets or sets the collection of custom places.

Declaration

cs-api-definition
public IList<string> CustomPlaces { get; }

Property Value

IList<string>

DialogForm

Declaration

cs-api-definition
protected FileDialogFormBase DialogForm { get; }

Property Value

FileDialogFormBase

ExpandToCurrentDirectory

Gets or sets a value indicating whether the main navigation pane expands and brings into view the current directory.

Declaration

cs-api-definition
public bool ExpandToCurrentDirectory { get; set; }

Property Value

bool

FileName

Gets or sets a string containing the selected file name, including the path. Short file name without the full path is not supported.

Declaration

cs-api-definition
public string FileName { get; set; }

Property Value

string

InitialDirectory

Gets or sets the initial directory.

Declaration

cs-api-definition
public string InitialDirectory { get; set; }

Property Value

string

InitialSelectedLayout

Gets or sets the initialLayoutType.

Declaration

cs-api-definition
public LayoutType InitialSelectedLayout { get; set; }

Property Value

LayoutType

RestoreDirectory

Gets or sets a value indicating whether the dialog box restores the directory to the previously selected directory before closing.

Declaration

cs-api-definition
public bool RestoreDirectory { get; set; }

Property Value

bool

ShowHiddenFiles

Gets or sets a boolean value indicating whether hidden files and folders should be visible in the Dialog.

Declaration

cs-api-definition
public bool ShowHiddenFiles { get; set; }

Property Value

bool

ShowNetworkLocations

Gets or sets a value indicating whether the dialog shows network computers in the navigation tree.

Declaration

cs-api-definition
public bool ShowNetworkLocations { get; set; }

Property Value

bool

Methods

CreateFileDialogForm()

Declaration

cs-api-definition
protected abstract FileDialogFormBase CreateFileDialogForm()

Returns

FileDialogFormBase

OpenFileInternal(FileMode, FileAccess)

Creates a FileStream with the specified FileMode and FileAccess.

Declaration

cs-api-definition
protected Stream OpenFileInternal(FileMode fileMode, FileAccess fileAccess)

Parameters

fileMode

FileMode

fileAccess

FileAccess

Returns

Stream

Exceptions

ArgumentNullException

Selected file is null.

ArgumentException

Selected file is empty string, contains only white space, contains one or more invalid characters, or refers to a non-file device.

NotSupportedException

Selected file refers to a non-file device.

Selected file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. The file must already exist in these modes.

An I/O error occurred or the stream has been closed.

The caller does not have the required permission.

Selected file is invalid, such as being on an unmapped drive.

UnauthorizedAccessException

The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.

ArgumentOutOfRangeException

The specified mode contains an invalid value.

ShowDialog()

Opens modal DialogWindow in case it hasn't been already opened.

Declaration

cs-api-definition
public DialogResult ShowDialog()

Returns

DialogResult

The DialogResult value.

ShowDialog(IWin32Window)

Opens modal DialogWindow in case it hasn't been already opened.

Declaration

cs-api-definition
public DialogResult ShowDialog(IWin32Window owner)

Parameters

owner

IWin32Window

Returns

DialogResult

The DialogResult value.

Events

DirectoryNavigating

Occurs when the current folder is about to change.

Declaration

cs-api-definition
public event EventHandler<DirectoryNavigatingEventArgs> DirectoryNavigating

Event Value

EventHandler<DirectoryNavigatingEventArgs>

DirectoryRequesting

Occurs when the DirectoryInfo wrapper is about to be created.

Declaration

cs-api-definition
public event EventHandler<DirectoryRequestingEventArgs> DirectoryRequesting

Event Value

EventHandler<DirectoryRequestingEventArgs>

ExceptionRaised

Occurs when the Exception is raised.

Declaration

cs-api-definition
public event EventHandler<FileBrowserExceptionRaisedEventArgs> ExceptionRaised

Event Value

EventHandler<FileBrowserExceptionRaisedEventArgs>

ShellContextMenuOpening

Occurs when context menu is about to open.

Declaration

cs-api-definition
public event EventHandler<ContextMenuOpeningEventArgs> ShellContextMenuOpening

Event Value

EventHandler<ContextMenuOpeningEventArgs>