StorageFolder.GetItemAsync(String) Метод

Определение

Пространство имен:

Windows.Storage

Возвращает файл или папку с указанным именем из текущей папки.

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)

Параметры

name

String

Platform::String

winrt::hstring

Имя (или путь относительно текущей папки) получаемого файла или папки.

Возвращаемое значение

IAsyncOperation<IStorageItem>

После успешного завершения этого метода возвращается объект IStorageItem , представляющий указанный файл или папку.

Для работы с возвращенным элементом вызовите метод IsOfType интерфейса IStorageItem , чтобы определить, является ли элемент файлом или папкой. Затем приведите элемент к StorageFolder или StorageFile.

Реализации

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

Атрибуты

RemoteAsyncAttribute

Исключения

FileNotFoundException

Указанный элемент не существует. Проверьте значение имени.

UnauthorizedAccessException

У вас нет разрешения на доступ к указанному элементу. Дополнительные сведения см. в разделе Разрешения на доступ к файлам.

ArgumentException

Путь не может быть в формате URI (например, /image.jpg). Проверьте значение имени.

Примеры

В следующем примере показано, как получить один файл или папку из текущей папки путем вызова метода GetItemAsync . В этом примере также показано, как получить элемент из вложенной папки текущей папки, указав относительный путь.

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  
});

Комментарии

Вызовите метод IsOfType интерфейса IStorageItem , чтобы определить, является ли возвращенный элемент файлом или папкой.

Чтобы получить определенный файл без приведения возвращаемого значения, вызовите метод GetFileAsync . Чтобы получить определенную папку без приведения возвращаемого значения, вызовите метод GetFolderAsync .

Чтобы попытаться получить файл или папку по имени или проверка, существует ли файл или папка, без необходимости обрабатывать исключение FileNotFoundException, вызовите метод TryGetItemAsync.

См. также раздел

• GetFileAsync(String)
• GetFolderAsync(String)
• TryGetItemAsync(String)
• Разрешения на доступ к файлам