Freigeben über


FolderPicker Klasse

Definition

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 FolderPicker
function FolderPicker()
Public NotInheritable Class FolderPicker
Vererbung
Object Platform::Object IInspectable FolderPicker
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.

Gilt für:

Weitere Informationen