FileDialog.Filter Eigenschap

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

Waarde van eigenschap

Een String met het filter. De standaardwaarde is Empty, wat betekent dat er geen filter wordt toegepast en dat alle bestandstypen worden weergegeven.

Uitzonderingen

Voorbeelden

In de volgende voorbeelden ziet u verschillende typen filtertekenreeksen die kunnen worden ingesteld met behulp van de Filter eigenschap.

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

Opmerkingen

Als Filter dit null het geval is of Empty, worden alle bestanden weergegeven en worden mappen altijd weergegeven.

U kunt een subset van bestandstypen opgeven die moeten worden weergegeven door de Filter eigenschap in te stellen. Elk bestandstype kan een specifiek type bestand vertegenwoordigen, zoals het volgende:

• Word documenten (*.doc)

• Excel Werkbladen (*.xls)

• PowerPoint presentaties (*.ppt)

Een bestandstype kan ook een groep gerelateerde bestandstypen vertegenwoordigen, zoals de volgende:

• Office-bestanden (*.doc, *.xls, *.ppt)

• Alle bestanden (*.*)

Als u een subset wilt opgeven van de typen bestanden die worden weergegeven, stelt u de Filter eigenschap in met een tekenreekswaarde (de filtertekenreeks) waarmee een of meer bestandstypen worden opgegeven waarop moet worden gefilterd. Hieronder ziet u de verwachte indeling van de filtertekenreeks:

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

U gebruikt de volgende indeling om elk bestandstype te beschrijven:

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

Het labelonderdeel is een door mensen leesbare tekenreekswaarde die het bestandstype beschrijft, zoals:

• "Word documenten"

• "Excel Werkbladen"

• "PowerPoint presentaties"

• "Office-bestanden"

• "Alle bestanden"

Elk bestandstype moet worden beschreven door ten minste één extensie. Als er meer dan één extensie wordt gebruikt, moet elke extensie worden gescheiden door een puntkomma (";"). Voorbeeld:

• "*.doc"

• "*.xls;"

• "*.ppt"

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

• "*.*"

Hier volgen volledige voorbeelden van geldige Filter tekenreekswaarden:

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

Elk bestandstype dat in het filter is opgenomen, wordt toegevoegd als een afzonderlijk item aan de bestandstypen: vervolgkeuzelijst in de OpenFileDialog of SaveFileDialog, zoals wordt weergegeven in de volgende afbeelding.

De gebruiker kan een bestandstype in deze lijst kiezen om op te filteren. Standaard wordt het eerste item in de lijst (bijvoorbeeld het eerste bestandstype) geselecteerd wanneer het OpenFileDialog of SaveFileDialog wordt weergegeven. Als u wilt opgeven dat een ander bestandstype moet worden geselecteerd, stelt u de FilterIndex eigenschap in voordat u de OpenFileDialog of SaveFileDialog (door aanroepen) ShowDialogweergeeft.

Zie ook

• FileName
• FilterIndex