KnownFolders Klasse
Definition
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.
Ermöglicht den Zugriff auf allgemeine Speicherorte, die Benutzerinhalte enthalten. Dazu gehören Inhalte aus den lokalen Bibliotheken eines Benutzers (z. B. Dokumente, Bilder, Musik und Videos), Heimnetzgruppe, Wechseldatenträger und Medienservergeräte.
public ref class KnownFolders abstract sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFoldersPublic Class KnownFolders- Vererbung
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Beispiele
Das Dateizugriffsbeispiel zeigt, wie Sie die PicturesLibrary-Eigenschaft verwenden, um eine neue Datei in der Bildbibliothek zu erstellen.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.
Nach Abschluss der CreateFileAsync-Methode enthält die file Variable eine StorageFile-Datei , die die neue Datei darstellt.
Hinweise
Diese Klasse ist statisch und kann nicht instanziiert werden. Greifen Sie direkt auf die Eigenschaften zu, wie im folgenden Beispiel gezeigt.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
Voraussetzungen
Um auf die Ordner und Bibliotheken zuzugreifen, die durch die Eigenschaften dieser Klasse dargestellt werden, geben Sie die entsprechenden Funktionen in Ihrem App-Manifest an. Wenn Sie beispielsweise auf KnownFolders.PicturesLibrary zugreifen möchten, geben Sie die Funktion Bilderbibliothek im App-Manifest an. Weitere Informationen zu Funktionen finden Sie in App-Funktionsdeklarationen.
Rückgabewert
Die Eigenschaften der KnownFolders-Klasse geben einen StorageFolder zurück. Um mit dem bekannten Ordner und seinem Inhalt zu arbeiten, rufen Sie die Methoden und Eigenschaften der StorageFolder-Klasse auf.
- Informationen zur Verwendung von Bildern, Musik und Videos in Ihrer App finden Sie unter Audio, Video und Kamera.
- Allgemeine Informationen zur Verwendung von Dateien und Ordnern finden Sie unter Aufzählen und Abfragen von Dateien und Ordnern.
Weitere Informationen
Hier erfahren Sie, wie Sie auf einige andere häufig verwendete Standorte zugreifen.
- Rufen Sie den lokalen Ordner der App aus der Windows.Storage.ApplicationData.Current.LocalFolder-Eigenschaft ab.
- Rufen Sie den Installationsordner der App aus der Windows.ApplicationModel.Package.Current.InstalledLocation-Eigenschaft ab.
Weitere Informationen zu den Speicherorten, auf die Ihre App zugreifen kann, finden Sie unter Dateizugriffsberechtigungen.
Versionsverlauf
| Windows-Version | SDK-Version | Wertschöpfung |
|---|---|---|
| 1511 | 10586 | GetFolderForUserAsync |
| 2004 | 19041 | GetFolderAsync |
| 2004 | 19041 | RequestAccessAsync |
| 2004 | 19041 | RequestAccessForUserAsync |
Eigenschaften
| AppCaptures |
Ruft den Ordner App Captures ab. |
| CameraRoll |
Ruft den Ordner Kamerarolle ab. |
| DocumentsLibrary |
Ruft die Bibliothek Dokumente ab. Die Bibliothek Dokumente ist nicht für die allgemeine Verwendung vorgesehen. |
| HomeGroup |
Ruft den Ordner Heimnetzgruppe ab. |
| MediaServerDevices |
Ruft den Ordner der Medienservergeräte (Digital Living Network Alliance ( DLNA) ab. |
| MusicLibrary |
Ruft die Musikbibliothek ab. |
| Objects3D |
Ruft den Ordner Objects 3D ab. |
| PicturesLibrary |
Ruft die Bildbibliothek ab. |
| Playlists |
Ruft den Ordner "Wiedergabelisten" ab. |
| RecordedCalls |
Ruft den Ordner "aufgezeichnete Aufrufe" ab. |
| RemovableDevices |
Ruft den Ordner "Wechselmedien" ab. |
| SavedPictures |
Ruft den Ordner Gespeicherte Bilder ab. |
| VideosLibrary |
Ruft die Videos-Bibliothek ab. |
Methoden
| GetFolderAsync(KnownFolderId) |
Ruft den Ordner für die angegebene folderId ab. |
| GetFolderForUserAsync(User, KnownFolderId) |
Statische Methode, die einen angegebenen bekannten Ordner für einen Benutzer zurückgibt. |
| RequestAccessAsync(KnownFolderId) |
Fordert zugriff für die Funktion an, die den Zugriff auf den Ordner steuert. |
| RequestAccessForUserAsync(User, KnownFolderId) |
Fordert Zugriff für den Benutzer und die folderId an. |