KnownFolders Klasse

Definition

Namespace:

Windows.Storage

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 KnownFolders

Public Class KnownFolders

Vererbung

Object Platform::Object IInspectable KnownFolders

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

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.

Weitere Informationen

• StorageFile
• StorageFolder
• Windows.Storage.Search
• Beispiel zum Dateizugriff
• Berechtigungen für den Dateizugriff
• Aufzählen und Abfragen von Dateien und Ordnern
• Heimnetzgruppenbeispiel (Windows 10)