FileDialog.Filter Proprietà

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à

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

Eccezioni

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 il seguente:

• Documenti di 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:

• 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 è 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 il seguente:

• "Documenti di 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 si usa più estensioni , ogni estensione deve essere separata da un punto e virgola (";"). Per 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 all'elenco a discesa File di tipo : 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 dell'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