Freigeben über


StorageFolder.GetFileAsync(String) Methode

Definition

Ruft die Datei mit dem angegebenen Namen aus dem aktuellen Ordner ab.

public:
 virtual IAsyncOperation<StorageFile ^> ^ GetFileAsync(Platform::String ^ name) = GetFileAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> GetFileAsync(winrt::hstring const& name);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> GetFileAsync(string name);
function getFileAsync(name)
Public Function GetFileAsync (name As String) As IAsyncOperation(Of StorageFile)

Parameter

name
String

Platform::String

winrt::hstring

Der Name (oder Pfad relativ zum aktuellen Ordner) der abzurufenden Datei.

Gibt zurück

Wenn diese Methode erfolgreich abgeschlossen wurde, wird eine StorageFile-Datei zurückgegeben, die die angegebene Datei darstellt.

Implementiert

M:Windows.Storage.IStorageFolder.GetFileAsync(System.String) M:Windows.Storage.IStorageFolder.GetFileAsync(Platform::String) M:Windows.Storage.IStorageFolder.GetFileAsync(winrt::hstring)
Attribute

Ausnahmen

Die angegebene Datei ist nicht vorhanden. Überprüfen Sie den Wert von name.

Sie sind nicht berechtigt, auf die angegebene Datei zuzugreifen. Weitere Informationen finden Sie unter Dateizugriffsberechtigungen.

Der Pfad darf nicht im URI-Format vorliegen (z. B. /image.jpg). Überprüfen Sie den Wert von name.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Datei aus dem aktuellen Ordner abrufen, indem Sie die GetFileAsync-Methode aufrufen. Dieses Beispiel zeigt auch, wie sie eine Datei aus einem Unterordner des aktuellen Ordners abrufen, indem Sie einen relativen Pfad angeben.

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

// Get the app's installation folder.
StorageFolder appFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;

// Get the app's manifest file from the current folder.
string name = "AppxManifest.xml";
StorageFile manifestFile = await appFolder.GetFileAsync(name);

// Get a file from a subfolder of the current folder
// by providing a relative path.
string image = @"Assets\Logo.scale-100.png";
StorageFile logoImage = await appFolder.GetFileAsync(image);
IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the app's installation folder.
    Windows::Storage::StorageFolder appFolder{ Windows::ApplicationModel::Package::Current().InstalledLocation() };

    // Get the app's manifest file from the current folder.
    std::wstring name{ L"AppxManifest.xml" };
    Windows::Storage::StorageFile manifest{ co_await appFolder.GetFileAsync(name) };
    // Do something with the manifest file.
}
// Get the app's installation folder
StorageFolder^ appFolder = Windows::ApplicationModel::Package::Current->InstalledLocation;

// Get the app's manifest file from the current folder
String^ name = "AppxManifest.xml";
create_task(appFolder->GetFileAsync(name)).then([=](StorageFile^ manifest){
 //Do something with the manifest file  
});

Hinweise

Um ein Element abzurufen, das eine Datei oder ein Ordner ist, rufen Sie die GetItemAsync-Methode auf.

Gilt für:

Weitere Informationen