StorageFolder Klasse

Referenz

Definition

Namespace:: Windows.Storage

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Verwaltet Ordner und deren Inhalte und stellt Informationen zu ihnen bereit.

public ref class StorageFolder sealed : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolder final : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolder : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

Public NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Vererbung: Object Platform::Object IInspectable StorageFolder

Attribute: ContractVersionAttribute

Implementiert: IStorageFolder IStorageFolder2 IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IStorageFolderQueryOperations

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	documentsLibrary musicLibrary picturesLibrary videosLibrary

Hinweise

In der Regel erhalten Sie StorageFolder-Objekte als Rückgabewert von asynchronen Methodenaufrufen. Beispielsweise gibt die statische Methode GetFolderFromPathAsync einen StorageFolder zurück, der den angegebenen Ordner darstellt.

Beachten Sie, dass die Dateiauswahl den Ordner als StorageFolder zurückgibt, wenn Sie eine Dateiauswahl aufrufen, damit der Benutzer einen Ordner auswählen kann.

Es gibt derzeit keine "MoveAsync" oder eine ähnliche Methode. Eine einfache Implementierung des Verschiebens eines Ordners besteht darin, den gewünschten Ordner abzurufen, an den gewünschten Speicherort zu kopieren und dann den ursprünglichen Ordner zu löschen.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1803	17134	TryGetChangeTracker
2004	19041	GetFolderFromPathForUserAsync

Eigenschaften

Attributes	Ruft die Attribute des aktuellen Ordners ab.
DateCreated	Ruft das Datum und die Uhrzeit ab, zu der der aktuelle Ordner erstellt wurde.
DisplayName	Ruft den benutzerfreundlichen Namen des aktuellen Ordners ab.
DisplayType	Ruft die benutzerfreundliche Beschreibung des Typs des Ordners ab. Beispiel `JPEG image`: .
FolderRelativeId	Ruft einen Bezeichner für den aktuellen Ordner ab. Diese ID ist eindeutig für das Abfrageergebnis oder StorageFolder , das den aktuellen Ordner oder die aktuelle Dateigruppe enthält, und kann verwendet werden, um zwischen Elementen zu unterscheiden, die denselben Namen haben.
Name	Ruft den Namen des aktuellen Ordners ab.
Path	Ruft den vollständigen Pfad des aktuellen Ordners im Dateisystem ab, wenn der Pfad verfügbar ist.
Properties	Ruft ein -Objekt ab, das Zugriff auf die inhaltsbezogenen Eigenschaften des aktuellen Ordners ermöglicht.
Provider	Ruft das StorageProvider-Objekt ab, das Informationen zum Dienst enthält, der den aktuellen Ordner speichert.

Methoden

AreQueryOptionsSupported(QueryOptions)	Gibt an, ob der aktuelle Ordner die angegebenen QueryOptions unterstützt.
CreateFileAsync(String)	Erstellt eine neue Datei mit dem angegebenen Namen im aktuellen Ordner.
CreateFileAsync(String, CreationCollisionOption)	Erstellt eine neue Datei im aktuellen Ordner. Diese Methode gibt auch an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im aktuellen Ordner vorhanden ist.
CreateFileQuery()	Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner enthält.
CreateFileQuery(CommonFileQuery)	Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner enthält. Ruft auch die Dateien aus den Unterordnern des aktuellen Ordners ab, wenn der Wert des Abfragearguments etwas anderes als CommonFileQuery.DefaultQuery ist. Dateien werden basierend auf der angegebenen CommonFileQuery sortiert.
CreateFileQueryWithOptions(QueryOptions)	Ruft ein Abfrageergebnisobjekt ab, das die Dateien im aktuellen Ordner und optional in den Unterordnern des aktuellen Ordners enthält. Die Ergebnisse basieren auf den angegebenen QueryOptions.
CreateFolderAsync(String)	Erstellt einen neuen Unterordner mit dem angegebenen Namen im aktuellen Ordner.
CreateFolderAsync(String, CreationCollisionOption)	Erstellt einen neuen Unterordner mit dem angegebenen Namen im aktuellen Ordner. Diese Methode gibt auch an, was zu tun ist, wenn ein Unterordner mit demselben Namen bereits im aktuellen Ordner vorhanden ist.
CreateFolderQuery()	Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner enthält.
CreateFolderQuery(CommonFolderQuery)	Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner enthält. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, ruft eine Liste mit virtuellen Ordnern ab, die Container für Dateigruppen in den Unterordnern des aktuellen Ordners darstellen. Dateien werden basierend auf dem angegebenen Wert aus der CommonFolderQuery-Enumeration in Ordner gruppiert.
CreateFolderQueryWithOptions(QueryOptions)	Ruft ein Abfrageergebnisobjekt ab, das die Unterordner im aktuellen Ordner und optional geschachtelte Unterordner enthält. Die Ergebnisse basieren auf den angegebenen QueryOptions.
CreateItemQuery()	Ruft ein Abfrageergebnisobjekt ab, das die Dateien und Unterordner im aktuellen Ordner enthält.
CreateItemQueryWithOptions(QueryOptions)	Ruft ein Abfrageergebnisobjekt ab, das die Dateien und Unterordner im aktuellen Ordner und optional in den Unterordnern des aktuellen Ordners enthält. Die Ergebnisse basieren auf den angegebenen QueryOptions.
DeleteAsync()	Löscht den aktuellen Ordner.
DeleteAsync(StorageDeleteOption)	Löscht den aktuellen Ordner. Diese Methode gibt auch an, ob der Ordner dauerhaft gelöscht werden soll.
GetBasicPropertiesAsync()	Ruft die grundlegenden Eigenschaften des aktuellen Ordners oder der aktuellen Dateigruppe ab.
GetFileAsync(String)	Ruft die Datei mit dem angegebenen Namen aus dem aktuellen Ordner ab.
GetFilesAsync()	Ruft die Dateien im aktuellen Ordner ab.
GetFilesAsync(CommonFileQuery)	Ruft die Dateien im aktuellen Ordner ab. Ruft auch die Dateien aus den Unterordnern des aktuellen Ordners ab, wenn der Wert des Abfragearguments etwas anderes als CommonFileQuery.DefaultQuery ist. Dateien werden basierend auf dem angegebenen Wert aus der CommonFileQuery-Enumeration sortiert.
GetFilesAsync(CommonFileQuery, UInt32, UInt32)	Ruft einen indexbasierten Bereich von Dateien aus der Liste aller Dateien im aktuellen Ordner ab. Ruft auch die Dateien aus den Unterordnern des aktuellen Ordners ab, wenn der Wert des Abfragearguments etwas anderes als CommonFileQuery.DefaultQuery ist. Dateien werden basierend auf dem angegebenen Wert aus der CommonFileQuery-Enumeration sortiert.
GetFolderAsync(String)	Ruft den Unterordner mit dem angegebenen Namen aus dem aktuellen Ordner ab.
GetFolderFromPathAsync(String)	Ruft den Ordner ab, der über den angegebenen absoluten Pfad im Dateisystem verfügt.
GetFolderFromPathForUserAsync(User, String)	Ruft den StorageFolder basierend auf einem absoluten Pfad im Dateisystem für einen bestimmten Benutzer ab.
GetFoldersAsync()	Ruft die Unterordner im aktuellen Ordner ab.
GetFoldersAsync(CommonFolderQuery)	Ruft die Unterordner im aktuellen Ordner ab. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, ruft eine Liste mit virtuellen Ordnern ab, die Container für Dateigruppen in den Unterordnern des aktuellen Ordners darstellen. Dateien werden basierend auf dem angegebenen Wert aus der CommonFolderQuery-Enumeration in Ordner gruppiert.
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)	Ruft einen indexbasierten Ordnerbereich aus der Liste aller Unterordner im aktuellen Ordner ab. Wenn der Wert des Abfragearguments etwas anderes als CommonFolderQuery.DefaultQuery ist, ruft eine Liste mit virtuellen Ordnern ab, die Container für Dateigruppen in den Unterordnern des aktuellen Ordners darstellen. Dateien werden basierend auf dem angegebenen Wert aus der CommonFolderQuery-Enumeration in Ordner gruppiert.
GetIndexedStateAsync()	Ruft den indizierten Zustand des aktuellen Ordners ab.
GetItemAsync(String)	Ruft die Datei oder den Ordner mit dem angegebenen Namen aus dem aktuellen Ordner ab.
GetItemsAsync()	Ruft die Dateien und Unterordner im aktuellen Ordner ab.
GetItemsAsync(UInt32, UInt32)	Ruft einen indexbasierten Bereich von Dateien und Ordnern aus der Liste aller Dateien und Unterordner im aktuellen Ordner ab.
GetParentAsync()	Ruft den übergeordneten Ordner des aktuellen Ordners ab.
GetScaledImageAsThumbnailAsync(ThumbnailMode)	Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht bestimmt wird.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht und der angeforderten Größe bestimmt wird.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Ruft ein skaliertes Bild als Miniaturansicht ab, die durch den Zweck der Miniaturansicht, die angeforderte Größe und die angegebenen Optionen bestimmt wird.
GetThumbnailAsync(ThumbnailMode)	Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß ist.
GetThumbnailAsync(ThumbnailMode, UInt32)	Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß und an die angeforderte Größe angepasst wird.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Ruft ein Miniaturbild für den aktuellen Ordner ab, das für den angegebenen Zweck der Miniaturansicht groß ist und mit den angegebenen Optionen an die angeforderte Größe angepasst wird.
IsCommonFileQuerySupported(CommonFileQuery)	Gibt an, ob der aktuelle Ordner die angegebene CommonFileQuery unterstützt.
IsCommonFolderQuerySupported(CommonFolderQuery)	Gibt an, ob der aktuelle Ordner die angegebene CommonFolderQuery unterstützt.
IsEqual(IStorageItem)	Gibt an, ob der aktuelle Ordner dem angegebenen Ordner entspricht.
IsOfType(StorageItemTypes)	Gibt an, ob der aktuelle StorageFolder mit dem angegebenen StorageItemTypes-Wert übereinstimmt.
RenameAsync(String)	Benennt den aktuellen Ordner um.
RenameAsync(String, NameCollisionOption)	Benennt den aktuellen Ordner um und gibt an, was zu tun ist, wenn bereits ein Ordner mit demselben Namen vorhanden ist.
TryGetChangeTracker()	Ruft den StorageLibraryChangeTracker ab, der einem StorageFolder zugeordnet ist.
TryGetItemAsync(String)	Versucht, die Datei oder den Ordner mit dem angegebenen Namen aus dem aktuellen Ordner abzurufen. Gibt null zurück, anstatt eine FileNotFoundException zu auslösen, wenn die angegebene Datei oder der angegebene Ordner nicht gefunden wird.

Gilt für: