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 が返されます。

返されたアイテムを操作するには、IStorageItem インターフェイスの IsOfType メソッドを呼び出して、アイテムがファイルかフォルダーかを判断します。 次に、アイテムを 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

指定された項目が存在しません。 name の値を確認 します。

UnauthorizedAccessException

指定したアイテムにアクセスするためのアクセス許可がありません。 詳細については、「 ファイル アクセス許可」を参照してください。

ArgumentException

パスを Uri 形式にすることはできません (たとえば、/image.jpg)。 name の値を確認 します。

例

次の例では、 GetItemAsync メソッドを呼び出して、現在のフォルダーから 1 つのファイルまたはフォルダーを取得する方法を示します。 この例では、相対パスを指定して、現在のフォルダーのサブフォルダーから項目を取得する方法も示します。

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

注釈

IStorageItem インターフェイスの IsOfType メソッドを呼び出して、返される項目がファイルかフォルダーかを判断します。

戻り値をキャストせずに特定のファイルを取得するには、 GetFileAsync メソッドを呼び出します。 戻り値をキャストせずに特定のフォルダーを取得するには、 GetFolderAsync メソッドを呼び出します。

FileNotFoundException を処理せずに、ファイルまたはフォルダーを名前で取得したり、ファイルまたはフォルダーが存在するかどうかをチェックするには、TryGetItemAsync メソッドを呼び出します。

こちらもご覧ください

• GetFileAsync(String)
• GetFolderAsync(String)
• TryGetItemAsync(String)
• ファイル アクセス許可