FileDialog.Filter Eigenschaft

Definition

Namespace:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Ruft die Filterzeichenfolge ab, die angibt, welche Dateitypen aus dem OpenFileDialog bzw. aus dem SaveFileDialog angezeigt werden, oder legt diese fest.

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

Eigenschaftswert

String

Eine String, die den Filter enthält. Der Standardwert ist Empty. Dies bedeutet, dass kein Filter angewendet wird und alle Dateitypen angezeigt werden.

Ausnahmen

ArgumentException

Die Filterzeichenfolge ist ungültig.

Beispiele

Die folgenden Beispiele veranschaulichen verschiedene Typen von Filterzeichenfolgen, die mithilfe der Filter -Eigenschaft festgelegt werden können.

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

Hinweise

Wenn Filter entweder null oder Emptyist, werden alle Dateien angezeigt, und Ordner werden immer angezeigt.

Sie können eine Teilmenge der anzuzeigenden Dateitypen angeben, indem Sie die Filter -Eigenschaft festlegen. Jeder Dateityp kann einen bestimmten Dateityp darstellen, z. B. den folgenden:

• Word Dokumente (*.doc)

• Excel-Arbeitsblätter (*.xls)

• PowerPoint-Präsentationen (*.ppt)

Alternativ kann ein Dateityp eine Gruppe verwandter Dateitypen darstellen, z. B. die folgenden:

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

• Alle Dateien (*.*)

Um eine Teilmenge der angezeigten Dateitypen anzugeben, legen Sie die Filter Eigenschaft mit einem Zeichenfolgenwert (der Filterzeichenfolge) fest, der einen oder mehrere Dateitypen angibt, nach denen gefiltert werden soll. Im Folgenden wird das erwartete Format der Filterzeichenfolge veranschaulicht:

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

Sie verwenden das folgende Format, um jeden Dateityp zu beschreiben:

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

Der Label-Teil ist ein für Menschen lesbarer Zeichenfolgenwert, der den Dateityp beschreibt, z. B. folgendes:

• "Word Dokumente"

• "Excel-Arbeitsblätter"

• "PowerPoint-Präsentationen"

• "Office-Dateien"

• "Alle Dateien"

Jeder Dateityp muss mit mindestens einer Erweiterung beschrieben werden. Wenn mehr als eine Erweiterung verwendet wird, muss jede Erweiterung durch ein Semikolon (";") getrennt werden. Beispiel:

• "*.doc"

• "*.xls;"

• "*.ppt"

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

• "*.*"

Im Folgenden sind vollständige Beispiele für gültige Filter Zeichenfolgenwerte aufgeführt:

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

Jeder im Filter enthaltene Dateityp wird der Dropdownliste Dateien vom Typ: in OpenFileDialog der oder SaveFileDialogals separates Element hinzugefügt, wie in der folgenden Abbildung gezeigt.

Der Benutzer kann einen Dateityp aus dieser Liste auswählen, nach dem er gefiltert werden soll. Standardmäßig wird das erste Element in der Liste (z. B. der erste Dateityp) ausgewählt, wenn oder OpenFileDialogSaveFileDialog angezeigt wird. Um anzugeben, dass ein anderer Dateityp ausgewählt werden soll, legen Sie die FilterIndex -Eigenschaft fest, bevor sie oder OpenFileDialogSaveFileDialog anzeigt (durch Aufrufen ShowDialogvon ).

Weitere Informationen

• FileName
• FilterIndex