StorageFolder.GetItemAsync(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 oder den Ordner mit dem angegebenen Namen aus dem aktuellen Ordner ab.

public:
 virtual IAsyncOperation<IStorageItem ^> ^ GetItemAsync(Platform::String ^ name) = GetItemAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IStorageItem> GetItemAsync(winrt::hstring const& name);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IStorageItem> GetItemAsync(string name);

function getItemAsync(name)

Public Function GetItemAsync (name As String) As IAsyncOperation(Of IStorageItem)

Parameter

name: String
Platform::String

winrt::hstring

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

Gibt zurück

IAsyncOperation<IStorageItem>

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein IStorageItem zurückgegeben, das die angegebene Datei oder den angegebenen Ordner darstellt.

Um mit dem zurückgegebenen Element zu arbeiten, rufen Sie die IsOfType-Methode der IStorageItem-Schnittstelle auf, um zu bestimmen, ob es sich bei dem Element um eine Datei oder einen Ordner handelt. Wandeln Sie das Element dann in einen StorageFolder - oder StorageFile-Wert um.

Implementiert

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

Attribute: RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

Das angegebene Element ist nicht vorhanden. Überprüfen Sie den Wert des Namens.

UnauthorizedAccessException

Sie verfügen nicht über die Berechtigung für den Zugriff auf das angegebene Element. Weitere Informationen finden Sie unter Dateizugriffsberechtigungen.

ArgumentException

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

Beispiele

Das folgende Beispiel zeigt, wie Sie eine einzelne Datei oder einen einzelnen Ordner aus dem aktuellen Ordner abrufen, indem Sie die GetItemAsync-Methode aufrufen. Dieses Beispiel zeigt auch, wie Sie ein Element 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.
string name = "AppxManifest.xml";
StorageFile manifestFile = (StorageFile)await appFolder.GetItemAsync(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 = (StorageFile)await appFolder.GetItemAsync(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.GetItemAsync(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->GetItemAsync(name)).then([=](IStorageItem^ manifest){
  //Do something with the manifest file  
});

Hinweise

Rufen Sie die IsOfType-Methode der IStorageItem-Schnittstelle auf, um zu bestimmen, ob das zurückgegebene Element eine Datei oder ein Ordner ist.

Um eine bestimmte Datei ohne Umwandlung des Rückgabewerts abzurufen, rufen Sie die GetFileAsync-Methode auf. Um einen bestimmten Ordner abzurufen, ohne den Rückgabewert zu umwandeln, rufen Sie die GetFolderAsync-Methode auf.

Rufen Sie die TryGetItemAsync-Methode auf, um zu versuchen, eine Datei oder einen Ordner nach Namen abzurufen oder zu überprüfen, ob eine Datei oder ein Ordner vorhanden ist, ohne dass eine FileNotFoundException behandelt werden muss.

Gilt für: