Back to Devexpress

FileDialogBase.FileName Property

windowsforms-devexpress-dot-xtraeditors-dot-filedialogbase-7f8e8476.md

latest4.2 KB
Original Source

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

csharp
[DefaultValue("")]
[DXCategory("Data")]
public string FileName { get; set; }
vb
<DefaultValue("")>
<DXCategory("Data")>
Public Property FileName As String

Property Value

TypeDefaultDescription
StringString.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.

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.

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

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

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

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

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

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

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

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

See Also

FileDialogBase Class

FileDialogBase Members

DevExpress.XtraEditors Namespace