StorageFolder.GetFolderFromPathAsync(String) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Ottiene la cartella con il percorso assoluto specificato nel file system.

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)

Parametri

path

String

Platform::String

winrt::hstring

Percorso assoluto nel file system (non l'URI) della cartella da ottenere.

Se il percorso usa le barre, assicurarsi di usare le barre rovesciata (\). Le barre (/) non vengono accettate da questo metodo.

Restituisce

IAsyncOperation<StorageFolder>

Al termine di questo metodo, restituisce un oggetto StorageFolder che rappresenta la cartella specificata.

Attributi

RemoteAsyncAttribute

Eccezioni

FileNotFoundException

La cartella specificata non esiste. Controllare il valore di path.

UnauthorizedAccessException

Non si dispone dell'autorizzazione per accedere alla cartella specificata. Per altre informazioni, vedere Autorizzazioni di accesso ai file.

ArgumentException

Il percorso non può essere un percorso relativo o un URI. Controllare il valore di path.

Esempio

Nell'esempio seguente viene illustrato come ottenere la cartella con il percorso assoluto specificato nel file system chiamando il metodo 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());
});

Vedi anche

• Autorizzazioni di accesso ai file