CommonFolderQuery Enumeration

Definition

Namespace:

Windows.Storage.Search

Gibt an, wie Dateien in Ordnern in den Abfrageergebnissen gruppiert werden, und bestimmt, ob die Abfrage flach oder tief ist. Abfrageergebnisse für tiefe Abfragen enthalten alle Dateien in allen Unterordnern des aktuellen Ordners, die gemäß der angegebenen Option in Ordnern gruppiert sind.

public enum class CommonFolderQuery

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CommonFolderQuery

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CommonFolderQuery

var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery

Public Enum CommonFolderQuery

Vererbung

Enum

CommonFolderQuery

Attribute

ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

DefaultQuery	0	Eine flache Liste der Ordner im aktuellen Ordner, ähnlich der Ansicht, die Explorer bereitstellt. Sie können diese Option für jeden Speicherort verwenden.
GroupByAlbum	103	Gruppieren Sie Dateien in virtuelle Ordner nach Jahr basierend auf der System.Music.AlbumTitle-Eigenschaft jeder Datei. Jeder Ordner enthält alle (und nur) Dateien mit identischen Werten für System.Music.AlbumTitle. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByAlbumArtist	104	Gruppieren Von Dateien in virtuelle Ordner basierend auf der System.Music.AlbumArtist-Eigenschaft jeder Datei. Jeder Ordner enthält alle (und nur) Dateien mit identischen Werten für System.Music.AlbumArtist. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByArtist	102	Gruppieren Von Dateien in virtuelle Ordner basierend auf der System.Music.Artist-Eigenschaft jeder Datei. Jeder Ordner enthält alle (und nur) Dateien mit identischen Werten für System.Music.Artist. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByAuthor	110	Gruppieren Sie Dateien in virtuellen Ordnern basierend auf der System.Author-Eigenschaft jeder Datei. Jeder Ordner stellt einen Autor dar und enthält alle Dateien, deren System.Author-Vektor diesen Autor enthält. Wenn eine Datei mehrere Autoren auflistet, kann sie in mehr als einem der resultierenden Ordner angezeigt werden. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByComposer	105	Gruppieren Sie Dateien in virtuellen Ordnern basierend auf der System.Music.Composer-Eigenschaft jeder Datei. Jeder Ordner stellt einen Komponisten dar und enthält alle Dateien, deren System.Music.Composer-Vektor diesen Komponisten enthält. Wenn eine Datei mehrere Komponisten auflistet, kann sie in mehr als einem der resultierenden Ordner angezeigt werden. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByGenre	106	Gruppieren Sie Dateien in virtuellen Ordnern basierend auf der System.Music.Genre-Eigenschaft jeder Datei. Jeder Ordner enthält alle (und nur) Dateien mit identischen Werten für System.Music.Genre. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByMonth	101	Gruppieren Sie Dateien in virtuellen Ordnern nach Monat basierend auf der System.ItemDate-Eigenschaft jeder Datei. Jeder Ordner enthält alle Dateien (und nur) mit Werten für System.ItemDate innerhalb desselben Monats. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByPublishedYear	107	Gruppieren Sie Dateien in virtuellen Ordnern nach Jahr basierend auf der System.Media.Year-Eigenschaft jeder Datei. Jeder Ordner enthält alle Dateien (und nur) mit Werten für System.Media.Year innerhalb desselben Jahres. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByRating	108	Gruppieren Sie Dateien in virtuellen Ordnern nach Bewertung (1 star, 2 Sterne usw.), basierend auf der System.Rating-Eigenschaft jeder Datei. Jeder Ordner enthält alle (und nur) Dateien mit identischen Werten für System.Rating. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByTag	109	Gruppieren Sie Dateien in virtuellen Ordnern basierend auf der System.Keywords-Eigenschaft jeder Datei. Jeder Ordner stellt ein Tag dar und enthält alle Dateien, deren System.Keywords-Vektor dieses Tag enthält. Wenn eine Datei mehrere Tags in ihrem System.Keywords-Vektor auflistet , kann sie in mehr als einem der resultierenden Ordner angezeigt werden. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByType	111	Gruppieren Sie Dateien in virtuellen Ordnern nach Typ (z. B. Microsoft Word Dokumente, Textdateien usw.), basierend auf der System.ItemTypeText-Eigenschaft jeder Datei. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.
GroupByYear	100	Gruppieren Sie Dateien in virtuellen Ordnern nach Jahr basierend auf der System.ItemDate-Eigenschaft jeder Datei. Jeder Ordner enthält alle Dateien (und nur) mit Werten für System.ItemDate innerhalb desselben Jahres. Sie können diese Option nur für Ordner in einer Bibliothek oder im Ordner "Heimnetzgruppe" verwenden.

Hinweise

Verwenden Sie einen Wert aus der CommonFolderQuery-Enumeration, wenn Sie eine der folgenden Methoden der StorageFolder-Klasse aufrufen. Beispiele, die Werte aus der CommonFolderQuery-Enumeration verwenden, finden Sie in den Themen zu diesen Methoden.

• CreateFolderQuery(CommonFolderQuery)
• CreateFolderQueryWithOptions. Instanziieren Sie queryOptions mit dem QueryOptions(CommonFolderQuery)- Konstruktor.
• CreateItemQueryWithOptions. Instanziieren Sie queryOptions mit dem QueryOptions(CommonFolderQuery)- Konstruktor.
• GetFoldersAsync(CommonFolderQuery)
• GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

Diese Methoden verwenden den Wert aus der CommonFolderQuery-Enumeration, um die Optionen DateStackOption, FolderDepth, IndexerOption und SortOrder der Abfrage zu initialisieren.

Rufen Sie die StorageFolder.IsCommonFolderQuerySupported-Methode auf, um zu bestimmen, ob der CommonFolderQuery-Wert, den Sie verwenden möchten, für den aktuellen Ordner verfügbar ist.

Tipp

Wenn eine Abfrage Dateien basierend auf einer Eigenschaft mit mehreren Werten (z . B. System.Author) in virtuellen Ordnern gruppiert, kann eine bestimmte Datei in mehr als einem virtuellen Ordner angezeigt werden, da jeder Ordner einen der mehreren Werte darstellt.

Dateien, die keinen Wert für die Eigenschaft haben, die die Abfrage zum Gruppieren von Dateien verwendet, werden in der Regel von Abfrageergebnissen ausgeschlossen.

Weitere Informationen

• QueryOptions(CommonFolderQuery)
• StorageFolder
• Ordneraufzählungsbeispiel (Windows 10)