StorageFile.GetFileFromPathForUserAsync(User, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient un objet StorageFile en fonction d’un chemin d’accès absolu dans le système de fichiers d’un utilisateur donné.
public:
static IAsyncOperation<StorageFile ^> ^ GetFileFromPathForUserAsync(User ^ user, Platform::String ^ path);
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> GetFileFromPathForUserAsync(User const& user, winrt::hstring const& path);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> GetFileFromPathForUserAsync(User user, string path);
function getFileFromPathForUserAsync(user, path)
Public Shared Function GetFileFromPathForUserAsync (user As User, path As String) As IAsyncOperation(Of StorageFile)
Paramètres
- user
- User
Utilisateur pour lequel le StorageFile est retourné.
- path
-
String
Platform::String
winrt::hstring
Chemin d’accès du fichier à obtenir un StorageFile à représenter.
Si votre chemin utilise des barres obliques, veillez à utiliser des barres obliques inverses (\). Les barres obliques (/) ne sont pas acceptées par cette méthode.
Retours
Une fois cette méthode terminée, elle retourne le fichier sous la forme d’un StorageFile.
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10, version 2004 (introduit dans 10.0.19041.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v10.0)
|
Exemples
async Task<StorageFile> GetStorageFileAsync(User user, string path) {
// It is possible the file no longer exists
// or permissions were changed so that the
// app no longer has access to the path.
try
{
return await StorageFile.GetFileFromPathForUserAsync(user, path);
}
catch( System.IO.IOException ex )
{
// File, or path not found I/O Exceptions can happen
// notify user or implement fallback, etc...
string message = ex.Message;
return null;
}
catch(System.UnauthorizedAccessException ex)
{
// Access denied - notify user or implement fallback, etc...
string message = ex.Message;
return null;
}
Remarques
Cette méthode est Multi-User Aware (MUA).