FileDialog.SupportMultiDottedExtensions Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets whether the dialog box supports displaying and saving files that have multiple file name extensions.
public:
property bool SupportMultiDottedExtensions { bool get(); void set(bool value); };
public bool SupportMultiDottedExtensions { get; set; }
member this.SupportMultiDottedExtensions : bool with get, set
Public Property SupportMultiDottedExtensions As Boolean
Property Value
true
if the dialog box supports multiple file name extensions; otherwise, false
. The default is false
.
Examples
The following code example saves files with the extension ".data.txt". This code example requires that your application host a SaveFileDialog named saveFileDialog1
and a Button named button1
.
using System;
using System.IO;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
namespace TestSaveFileDialog
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
button1.Click += new EventHandler(button1_Click);
}
private void button1_Click(object sender, EventArgs e)
{
saveFileDialog1.Filter = "Data text files|.data.txt";
saveFileDialog1.SupportMultiDottedExtensions = true;
saveFileDialog1.FileOk += new CancelEventHandler(saveFileDialog1_FileOk);
saveFileDialog1.ShowDialog();
}
void saveFileDialog1_FileOk(object sender, CancelEventArgs e)
{
try
{
Stream s = saveFileDialog1.OpenFile();
StreamWriter sw = new StreamWriter(s, Encoding.Unicode);
sw.WriteLine("Hello, world!");
sw.Close();
}
catch (Exception ex)
{
MessageBox.Show("Error: Could not write file. Please try again later. Error message: " + ex.Message, "Error Writing File", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}
}
}
}
Imports System.IO
Imports System.Text
Public Class Form1
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
Me.SaveFileDialog1.SupportMultiDottedExtensions = True
Me.SaveFileDialog1.Filter = "Data text files|*.data.txt"
Me.SaveFileDialog1.ShowDialog()
End Sub
Private Sub SaveFileDialog1_FileOk(ByVal sender As Object, ByVal e As System.ComponentModel.CancelEventArgs) Handles SaveFileDialog1.FileOk
Try
Dim MyFile As StreamWriter = New StreamWriter(Me.SaveFileDialog1.OpenFile(), Encoding.Unicode)
MyFile.WriteLine("Hello, world!")
MyFile.Close()
Catch ex As Exception
MessageBox.Show("Error: Could not write file. Please try again later. Error message: " & ex.Message, "Error Writing File", MessageBoxButtons.OK, MessageBoxIcon.Exclamation)
End Try
End Sub
End Class
Remarks
Sometimes users must open and save files that use multiple file name extensions. For example, the application manifest files used by the ClickOnce deployment technology end in the complex file name extension ".exe.manifest". Setting this property to true
enables you to set the Filter property to a multi-dotted extension.
If SupportMultiDottedExtensions is false
, and you assign a multi-dotted extension to Filter, derived controls such as SaveFileDialog will only use the last extension in the string. For example, ".manifest" will be used instead of ".exe.manifest".
Applies to
See also
.NET