FileDialog.Filter Proprietà

Definizione

Spazio dei nomi:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Ottiene o imposta la stringa di filtro che determina i tipi di file visualizzati da OpenFileDialog o SaveFileDialog.

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };

public string Filter { get; set; }

member this.Filter : string with get, set

Public Property Filter As String

Valore della proprietà

String

Oggetto String contenente il filtro. Il valore predefinito è Empty, che indica che non viene applicato alcun filtro e vengono visualizzati tutti i tipi di file.

Eccezioni

ArgumentException

La stringa di filtro non è valida.

Esempio

Negli esempi seguenti vengono illustrati diversi tipi di stringhe di filtro che possono essere impostate usando la Filter proprietà .

OpenFileDialog dlg = new OpenFileDialog();

// Show all files
dlg.Filter = string.Empty;

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Show all files
dlg.Filter = String.Empty

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Show all files
dlg.Filter = null;

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Show all files
dlg.Filter = Nothing

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Word Documents
dlg.Filter = "Word Documents|*.doc";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Word Documents
dlg.Filter = "Word Documents|*.doc"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Excel Worksheets
dlg.Filter = "Excel Worksheets|*.xls";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Excel Worksheets
dlg.Filter = "Excel Worksheets|*.xls"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by PowerPoint Presentations
dlg.Filter = "PowerPoint Presentations|*.ppt";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by PowerPoint Presentations
dlg.Filter = "PowerPoint Presentations|*.ppt"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Office Files
dlg.Filter = "Office Files|*.doc;*.xls;*.ppt";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Office Files
dlg.Filter = "Office Files|*.doc;*.xls;*.ppt"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by All Files
dlg.Filter = "All Files|*.*";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by All Files
dlg.Filter = "All Files|*.*"

dlg.ShowDialog()

OpenFileDialog dlg = new OpenFileDialog();

// Filter by Word Documents OR Excel Worksheets OR PowerPoint Presentations 
//           OR Office Files 
//           OR All Files
dlg.Filter = "Word Documents|*.doc|Excel Worksheets|*.xls|PowerPoint Presentations|*.ppt" +
             "|Office Files|*.doc;*.xls;*.ppt" +
             "|All Files|*.*";

dlg.ShowDialog();

Dim dlg As New OpenFileDialog()

' Filter by Word Documents OR Excel Worksheets OR PowerPoint Presentations 
'           OR Office Files 
'           OR All Files
dlg.Filter = "Word Documents|*.doc|Excel Worksheets|*.xls|PowerPoint Presentations|*.ppt" & "|Office Files|*.doc;*.xls;*.ppt" & "|All Files|*.*"

dlg.ShowDialog()

Commenti

Se Filter è null o Empty, vengono visualizzati tutti i file e le cartelle vengono sempre visualizzate.

È possibile specificare un subset di tipi di file da visualizzare impostando la Filter proprietà . Ogni tipo di file può rappresentare un tipo specifico di file, ad esempio quanto segue:

• documenti Word (*.doc)

• Fogli di lavoro di Excel (*.xls)

• Presentazioni di PowerPoint (*.ppt)

In alternativa, un tipo di file può rappresentare un gruppo di tipi di file correlati, ad esempio quanto segue:

• File di Office (*.doc, *.xls, *.ppt)

• Tutti i file (*.*)

Per specificare un subset dei tipi di file visualizzati, impostare la Filter proprietà con un valore stringa (stringa di filtro) che specifica uno o più tipi di file da filtrare. Di seguito viene illustrato il formato previsto della stringa di filtro:

FileType1[[|FileType2]...[|FileTypeN]]

Usare il formato seguente per descrivere ogni tipo di file:

Label|Extension1[[;Extension2]...[;ExtensionN]]

La parte Label è un valore stringa leggibile che descrive il tipo di file, ad esempio quanto segue:

• "documenti Word"

• "Fogli di lavoro di Excel"

• "Presentazioni di PowerPoint"

• "File di Office"

• "Tutti i file"

Ogni tipo di file deve essere descritto da almeno un'estensione. Se viene usata più estensioni , ogni estensione deve essere separata da un punto e virgola (";"). Ad esempio:

• "*.doc"

• "*.xls;"

• "*.ppt"

• "*.doc;*.xls;*.ppt"

• "*.*"

Di seguito sono riportati esempi completi di valori stringa validi Filter :

• Word Documents|*.doc

• Excel Worksheets|*.xls

• PowerPoint Presentations|*.ppt

• Office Files|*.doc;*.xls;*.ppt

• All Files|*.*

• Word Documents|*.doc|Excel Worksheets|*.xls|PowerPoint Presentations|*.ppt|Office Files|*.doc;*.xls;*.ppt|All Files|*.*

Ogni tipo di file incluso nel filtro viene aggiunto come elemento separato al file di tipo: elenco a discesa in OpenFileDialog o SaveFileDialog, come illustrato nella figura seguente.

L'utente può scegliere un tipo di file da questo elenco per filtrare. Per impostazione predefinita, il primo elemento nell'elenco (ad esempio, il primo tipo di file) viene selezionato quando OpenFileDialog viene visualizzato o SaveFileDialog . Per specificare che è necessario selezionare un altro tipo di file, impostare la FilterIndex proprietà prima di visualizzare o OpenFileDialogSaveFileDialog (chiamando ShowDialog).

Vedi anche

• FileName
• FilterIndex