FileDialog.Filter Egenskap

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

Egenskapsvärde

En String som innehåller filtret. Standardvärdet är Empty, vilket innebär att inget filter tillämpas och att alla filtyper visas.

Undantag

Exempel

I följande exempel visas flera typer av filtersträngar som kan anges med hjälp Filter av egenskapen .

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()

Kommentarer

Om Filter är antingen null eller Emptyvisas alla filer och mappar visas alltid.

Du kan ange en delmängd av filtyper som ska visas genom att ange egenskapen Filter . Varje filtyp kan representera en viss typ av fil, till exempel följande:

• Word dokument (*.doc)

• Excel kalkylblad (*.xls)

• PowerPoint presentationer (*.ppt)

Alternativt kan en filtyp representera en grupp med relaterade filtyper, till exempel följande:

• Office Files (*.doc, *.xls, *.ppt)

• Alla filer (*.*)

Om du vill ange en delmängd av de typer av filer som visas anger Filter du egenskapen med ett strängvärde ( filtersträngen) som anger en eller flera typer av filer som ska filtreras efter. Följande visar det förväntade formatet för filtersträngen:

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

Du använder följande format för att beskriva varje filtyp:

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

Delen Etikett är ett läsbart strängvärde som beskriver filtypen, till exempel följande:

• "Word dokument"

• "Excel kalkylblad"

• "PowerPoint presentationer"

• "Office-filer"

• "Alla filer"

Varje filtyp måste beskrivas av minst ett tillägg. Om fler än ett tillägg används måste varje tillägg avgränsas med ett semikolon (";"). Ett exempel:

• "*.doc"

• "*.xls;"

• "*.ppt"

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

• "*.*"

Följande är fullständiga exempel på giltiga Filter strängvärden:

• 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|*.*

Varje filtyp som ingår i filtret läggs till som ett separat objekt i listrutan Filer av typen: i OpenFileDialog listrutan eller SaveFileDialog, enligt följande bild.

Användaren kan välja en filtyp i den här listan att filtrera efter. Som standard väljs det första objektet i listan (till exempel den första filtypen) när OpenFileDialog eller SaveFileDialog visas. Om du vill ange att en annan filtyp ska väljas anger FilterIndex du egenskapen innan du OpenFileDialog visar eller SaveFileDialog (genom att anropa ShowDialog).

Se även

• FileName
• FilterIndex