StorageFolder.GetFolderFromPathAsync(String) Méthode

Définition

Espace de noms:

Windows.Storage

Obtient le dossier qui a le chemin d’accès absolu spécifié dans le système de fichiers.

public:
 static IAsyncOperation<StorageFolder ^> ^ GetFolderFromPathAsync(Platform::String ^ path);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFolder> GetFolderFromPathAsync(winrt::hstring const& path);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFolder> GetFolderFromPathAsync(string path);

function getFolderFromPathAsync(path)

Public Shared Function GetFolderFromPathAsync (path As String) As IAsyncOperation(Of StorageFolder)

Paramètres

path

String

Platform::String

winrt::hstring

Chemin d’accès absolu dans le système de fichiers (et non l’URI) du dossier à obtenir.

Si votre chemin d’accès utilise des barres obliques, veillez à utiliser des barres obliques inverses (\). Les barres obliques (/) ne sont pas acceptées par cette méthode.

Retours

IAsyncOperation<StorageFolder>

Lorsque cette méthode se termine correctement, elle retourne un StorageFolder qui représente le dossier spécifié.

Attributs

RemoteAsyncAttribute

Exceptions

FileNotFoundException

Le dossier spécifié n’existe pas. Vérifiez la valeur du chemin d’accès.

UnauthorizedAccessException

Vous n’êtes pas autorisé à accéder au dossier spécifié. Pour plus d’informations, consultez Autorisations d’accès aux fichiers.

ArgumentException

Le chemin d’accès ne peut pas être un chemin relatif ou un URI. Vérifiez la valeur du chemin d’accès.

Exemples

L’exemple suivant montre comment obtenir le dossier qui a le chemin absolu spécifié dans le système de fichiers en appelant la méthode GetFolderFromPathAsync.

using Windows.Storage;
using System.Threading.Tasks;

// Get the path to the app's Assets folder.
string root = Windows.ApplicationModel.Package.Current.InstalledLocation.Path;
string path = root + @"\Assets";

// Get the folder object that corresponds to this absolute path in the file system.
StorageFolder folder = await StorageFolder.GetFolderFromPathAsync(path);

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the path to the app's Assets folder.
    std::wstring path{ Windows::ApplicationModel::Package::Current().InstalledLocation().Path() + L"\\Assets" };

    // Get the folder object that corresponds to this absolute path in the file system.
    Windows::Storage::StorageFolder folder{ co_await Windows::Storage::StorageFolder::GetFolderFromPathAsync(path) };
    ::OutputDebugString(folder.Name().c_str());
}

// Get the path to the app's installation folder.
String^ root = Windows::ApplicationModel::Package::Current->InstalledLocation->Path;

// Get the folder object that corresponds to
// this absolute path in the file system.
create_task(StorageFolder::GetFolderFromPathAsync(root)).then([=](StorageFolder^ folder){
 String^ output = folder->Name;
 OutputDebugString(output->Begin());
});

Voir aussi

• Autorisations d’accès aux fichiers