FolderPicker 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.
Stellt ein UI-Element dar, mit dem der Benutzer Ordner auswählen kann.
In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.
public ref class FolderPicker sealed/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FolderPicker final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class FolderPicker final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FolderPicker final[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FolderPicker[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class FolderPicker[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FolderPickerfunction FolderPicker()Public NotInheritable Class FolderPicker- Vererbung
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
Informationen zu den ersten Schritten zum Zugreifen auf Dateien und Ordner mit einer Auswahl finden Sie unter Öffnen von Dateien und Ordnern mit einer Auswahl.
Versionsverlauf
| Windows-Version | SDK-Version | Wertschöpfung |
|---|---|---|
| 1903 | 18362 | CreateForUser |
| 1903 | 18362 | Benutzer |
Konstruktoren
| FolderPicker() |
Erstellt eine neue instance eines FolderPicker. In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen. |
Eigenschaften
| CommitButtonText |
Ruft den Bezeichnungstext der Commitschaltfläche der Ordnerauswahl ab oder legt diesen fest. |
| ContinuationData |
Ruft einen Satz von Werten ab, die von der App vor einem PickFolderAndContinue-Vorgang aufgefüllt werden sollen, der die App deaktiviert, um Kontext bereitzustellen, wenn die App aktiviert wird. (Windows Phone 8.x-App) |
| FileTypeFilter |
Ruft die Auflistung von Dateitypen ab, die von der Ordnerauswahl angezeigt wird. |
| SettingsIdentifier |
Ruft den Einstellungsbezeichner ab, der dem aktuellen FolderPicker-instance zugeordnet ist, oder legt diese fest. |
| SuggestedStartLocation |
Ruft den ursprünglichen Speicherort ab, an dem die Ordnerauswahl nach Ordnern sucht, die dem Benutzer angezeigt werden sollen, oder legt diesen fest. |
| User |
Ruft Informationen zu dem Benutzer ab, für den der FolderPicker erstellt wurde. Verwenden Sie diese Eigenschaft für Anwendungen mit mehreren Benutzern. |
| ViewMode |
Ruft den Ansichtsmodus ab, den die Ordnerauswahl zum Anzeigen von Elementen verwendet, oder legt diesen fest. |
Methoden
| CreateForUser(User) |
Erstellt einen FolderPicker , der auf das persönliche Verzeichnis des angegebenen Benutzers festgelegt ist. Verwenden Sie diese Methode für Anwendungen mit mehreren Benutzern. |
| PickFolderAndContinue() |
Veraltet ab Windows 10; verwenden Sie stattdessen PickSingleFolderAsync. Zeigt die Dateiauswahl an, damit der Benutzer einen Ordner auswählen, die App und nach Abschluss des Vorgangs deaktivieren und reaktivieren kann. (Windows Phone 8.x-App) |
| PickSingleFolderAsync() |
Zeigt das folderPicker-Objekt an, damit der Benutzer einen Ordner auswählen kann. (UWP-App) Hinweis Sie müssen den FileTypeFilter angeben, bevor Sie diese Methode aufrufen, sonst wird eine Ausnahme ausgelöst. Um alle Ordner aufzulisten, verwenden Sie "*" als Filter. |