Freigeben über


KnownFolders Klasse

Definition

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

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.

Weitere Informationen

Hier erfahren Sie, wie Sie auf einige andere häufig verwendete Standorte zugreifen.

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.

Gilt für:

Weitere Informationen