FileDialog.Filter Eigenschaft

Definition

Ruft die Filterzeichenfolge ab, die angibt, welche Dateitypen aus dem OpenFileDialog bzw. aus dem SaveFileDialog angezeigt werden, oder legt diese fest.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or 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

Eigenschaftswert

Ein String, der den Filter enthält.A String that contains the filter. Der Standardwert ist Empty. Dies bedeutet, dass kein Filter angewendet wird und alle Dateitypen angezeigt werden.The default is Empty, which means that no filter is applied and all file types are displayed.

Ausnahmen

Die Filterzeichenfolge ist ungültig.The filter string is invalid.

Beispiele

In den folgenden Beispielen werden verschiedene Typen von Filter Zeichenfolgen veranschaulicht, die mit der Filter-Eigenschaft festgelegt werden können.The following examples demonstrate several types of filter strings that can be set by using the Filter property.

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.If Filter is either null or Empty, all files are displayed, and folders are always displayed.

Sie können eine Teilmenge der Dateitypen angeben, die angezeigt werden sollen, indem Sie die Filter-Eigenschaft festlegen.You can specify a subset of file types to be displayed by setting the Filter property. Jeder Dateityp kann einen bestimmten Dateityp darstellen, wie z. b. Folgendes:Each file type can represent a specific type of file, such as the following:

  • Word-Dokumente (*. doc)Word Documents (*.doc)

  • Excel-Arbeitsblätter (*. xls)Excel Worksheets (*.xls)

  • PowerPoint-Präsentationen (*. ppt)PowerPoint Presentations (*.ppt)

Alternativ kann ein Dateityp eine Gruppe verwandter Dateitypen darstellen, wie z. b. die folgenden:Alternatively, a file type can represent a group of related file types, such as the following:

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

  • Alle Dateien (*.*)All Files (*.*)

Wenn Sie eine Teilmenge der angezeigten Dateitypen angeben möchten, legen Sie die Filter-Eigenschaft mit einem Zeichen folgen Wert (der Filter Zeichenfolge) fest, der einen oder mehrere Typen von Dateien angibt, nach denen gefiltert werden soll.To specify a subset of the types of files that are displayed, you set the Filter property with a string value (the filter string) that specifies one or more types of files to filter by. Folgendes zeigt das erwartete Format der Filter Zeichenfolge:The following shows the expected format of the filter string:

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

Verwenden Sie das folgende Format, um jeden Dateityp zu beschreiben:You use the following format to describe each file type:

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

Der Bezeichnungs Teil ist ein lesbarer Zeichen folgen Wert , der den Dateityp beschreibt, wie z. b. Folgendes:The Label part is a human-readable string value that describes the file type, such as the following:

  • "Word-Dokumente""Word Documents"

  • "Excel-Arbeitsblätter""Excel Worksheets"

  • "PowerPoint-Präsentationen""PowerPoint Presentations"

  • "Office-Dateien""Office Files"

  • "Alle Dateien""All Files"

Jeder Dateityp muss von mindestens einer Erweiterungbeschrieben werden.Each file type must be described by at least one Extension. Wenn mehr als eine Erweiterung verwendet wird, muss jede Erweiterung durch ein Semikolon (";") getrennt werden.If more than one Extension is used, each Extension must be separated by a semicolon (";"). Beispiel:For example:

  • "*. doc""*.doc"

  • "*. xls;""*.xls;"

  • "*. ppt""*.ppt"

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

  • "*.*""*.*"

Im folgenden finden Sie Beispiele für gültige Filter Zeichen folgen Werte:The following are complete examples of valid Filter string values:

  • 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 Dateityp, der im Filter enthalten ist, wird in der OpenFileDialog oder SaveFileDialogals separates Element der Dateityp: Dropdown Liste hinzugefügt, wie in der folgenden Abbildung dargestellt.Each file type that is included in the filter is added as a separate item to the Files of type: drop-down list in the OpenFileDialog or SaveFileDialog, as shown in the following figure.

Verwenden von "FileDialog. Filter" im Dialog Feld "Öffnen"Using the FileDialog.Filter in the Open Dialog Box

Der Benutzer kann einen Dateityp aus dieser Liste auswählen, nach dem gefiltert werden soll.The user can choose a file type from this list to filter by. Standardmäßig wird das erste Element in der Liste (z. b. der erste Dateityp) ausgewählt, wenn die OpenFileDialog oder SaveFileDialog angezeigt wird.By default, the first item in the list (for example, the first file type) is selected when the OpenFileDialog or SaveFileDialog is displayed. Um anzugeben, dass ein anderer Dateityp ausgewählt werden soll, legen Sie die FilterIndex-Eigenschaft fest, bevor Sie die OpenFileDialog oder SaveFileDialog (durch Aufrufen von ShowDialog) anzeigt.To specify that another file type to be selected, you set the FilterIndex property before showing the OpenFileDialog or SaveFileDialog (by calling ShowDialog).

Gilt für:

Siehe auch