New to Telerik UI for WinForms? Download free 30-day trial

Events

This article lists the events specific to all of the RadFileDialog controls.

  • OpenFileDialogForm.FormClosing: This event occurs when the dialog is closing. The event arguments are of type FormClosingEventArgs. You can use the arguments to cancel the event.

Example 1: Cancel dialog closing

        private void OpenFileDialogForm_FormClosing(object sender, FormClosingEventArgs e)
        {
            e.Cancel = true;
        }



Private Sub OpenFileDialogForm_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs)
    e.Cancel = True
End Sub

  • OpenFileDialogForm.FormClosed: This event occurs when the dialog is closed. The event arguments are of type FormClosedEventArgs.

  • ExceptionRaised: This event occurs when an exception is raised. This event could be raised in different occasions, for example - if the selected folder cannot be accessed or if the file path is too long, or when there is an error while searching, etc.

Example 2: Showing an alert when an error appears


        private void openFileDialog_ExceptionRaised(object sender, FileBrowserExceptionRaisedEventArgs e)
        {
            MessageBox.Show(e.Exception.Message);
        }


Private Sub openFileDialog_ExceptionRaised(ByVal sender As Object, ByVal e As FileBrowserExceptionRaisedEventArgs)
    MessageBox.Show(e.Exception.Message)
End Sub

  • DirectoryRequesting: This event can be used to filter the navigation RadTreeView. The following example demonstrates how you can filter out the "D:\" and "K:\" directories:

Example 3: Filtering the D and K directories


        private void openFileDialog_DirectoryRequesting(object sender, DirectoryRequestingEventArgs e)
        {
            if (e.Directory.FullName.StartsWith(@"D:\") || e.Directory.FullName.StartsWith(@"K:\"))
            {
                e.Cancel = true;
            }
        }


Private Sub openFileDialog_DirectoryRequesting(ByVal sender As Object, ByVal e As DirectoryRequestingEventArgs)
    If e.Directory.FullName.StartsWith("D:\") OrElse e.Directory.FullName.StartsWith("K:\") Then
        e.Cancel = True
    End If
End Sub

If the InitialDirectory of the RadFileDialog is filtered out as in Example 3, the current directory on load will be the default one.

Figure 1: Unfiltered Directories

WinForms RadFile-Dialogs Unfiltered Directories

Figure 2: Filtered Directories Based on Example 3

WinForms RadFile-Dialogs Filtered Directories Based on Example

  • OpenFileDialogForm.DirectoryNavigating: As of R1 2020 SP1, RadFileDialogs offer the DirectoryNavigating event. It occurs when the current folder is about to change. In the DirectoryNavigatingEventArgs you have access to the new directory path to be navigated via the DirectoryPath property. This event can be canceled. Hence, if the end-user doesn't have permissions for a specific folder, set the Cancel argument to true.

Example 4: Cancel navigating to a specific directory


private void OpenFileDialog_DirectoryNavigating(object sender, Telerik.WinControls.FileDialogs.DirectoryNavigatingEventArgs e)
{
    if (e.DirectoryPath == @"C:\Program Files")
    {
        e.Cancel = true;
    }
}       


Private Sub OpenFileDialog_DirectoryNavigating(ByVal sender As Object, ByVal e As Telerik.WinControls.FileDialogs.DirectoryNavigatingEventArgs)
    If e.DirectoryPath = "C:\Program Files" Then
        e.Cancel = True
    End If
End Sub

See Also

In this article