StorageFolder.GetFileAsync(String) Methode

Referenz

Definition

Namespace:: Windows.Storage

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

IAsyncOperation<StorageFile>

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: RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentException

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: