FileDialogBase.FileName Property

SECURITY-RELATED CONSIDERATIONS

Using file paths sourced from untrusted input may expose unauthorized files or allow unintended file access. Always validate and normalize all external paths to prevent path manipulation.

Gets or sets the selected file name, or an empty string if no file was selected. This property is identical to the standard FileDialog.FileName property.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraDialogs.v25.2.dll

NuGet Packages: DevExpress.Win.Dialogs, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue("")]
[DXCategory("Data")]
public string FileName { get; set; }

VB.NET

<DefaultValue("")>
<DXCategory("Data")>
Public Property FileName As String

Property Value

Type	Default	Description
String	String.Empty	The selected file name.

Remarks

In XtraSaveFileDialog, the FileName property specifies the name under which the file is saved. In XtraOpenFileDialog, the FileName can be one of two things:

• if the dialog’s MultiSelect property equals false, the FileName is the name of the opened file;
• if the dialog’s MultiSelect property equals true, the FileName is the name of first selected file. For a complete list of opened files’ names, use the FileNames property instead.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FileName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-richedit-control-mail-merge/CS/MailMerge/Form1.cs#L52

{
    string fName = fileDialog.FileName;
    if (fName != "")

winforms-richedit-save-a-document/CS/SaveDocument/CustomCommand.cs#L43

dialog.Filter = "Rich Text Format Files (*.rtf)|*.rtf|All Files (*.*)|*.*";
dialog.FileName = "SavedDocument.rtf";
dialog.RestoreDirectory = true;

VB.NET

winforms-richedit-control-mail-merge/VB/MailMerge/Form1.vb#L47

If dialogResult = System.Windows.Forms.DialogResult.OK Then
    Dim fName As String = fileDialog.FileName

winforms-richedit-save-a-document/VB/SaveDocument/CustomCommand.vb#L47

If dialog.ShowDialog() = DialogResult.OK Then
    CType(Control, RichEditControl).SaveDocument(dialog.FileName, DocumentFormat.Rtf)
End If