StorageFolder.GetItemAsync(String) Metode

Referensi

Definisi

Ruang nama:: Windows.Storage

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mendapatkan file atau folder dengan nama yang ditentukan dari folder saat ini.

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

Nama (atau jalur relatif terhadap folder saat ini) dari file atau folder yang akan didapatkan.

Mengembalikan

IAsyncOperation<IStorageItem>

Ketika metode ini berhasil diselesaikan, ia mengembalikan IStorageItem yang mewakili file atau folder yang ditentukan.

Untuk bekerja dengan item yang dikembalikan, panggil metode IsOfType antarmuka IStorageItem untuk menentukan apakah item tersebut adalah file atau folder. Kemudian transmisikan item ke StorageFolder atau StorageFile.

Penerapan

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

Atribut: RemoteAsyncAttribute

Pengecualian

FileNotFoundException

Item yang ditentukan tidak ada. Periksa nilai nama.

UnauthorizedAccessException

Anda tidak memiliki izin untuk mengakses item yang ditentukan. Untuk informasi selengkapnya, lihat Izin akses file.

ArgumentException

Jalur tidak dapat dalam format Uri (misalnya, /image.jpg). Periksa nilai nama.

Contoh

Contoh berikut menunjukkan cara mendapatkan satu file atau folder dari folder saat ini dengan memanggil metode GetItemAsync . Contoh ini juga menunjukkan cara mendapatkan item dari subfolder folder saat ini dengan menyediakan jalur relatif.

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

Keterangan

Panggil metode IsOfType antarmuka IStorageItem untuk menentukan apakah item yang dikembalikan adalah file atau folder.

Untuk mendapatkan file tertentu tanpa mentransmisikan nilai pengembalian, panggil metode GetFileAsync . Untuk mendapatkan folder tertentu tanpa transmisi nilai pengembalian, panggil metode GetFolderAsync .

Untuk mencoba mendapatkan file atau folder berdasarkan nama, atau untuk memeriksa apakah file atau folder ada, tanpa perlu menangani FileNotFoundException, panggil metode TryGetItemAsync .

Berlaku untuk

Bagikan melalui