StorageFile Kelas

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

Mewakili file. Menyediakan informasi tentang file dan kontennya, dan cara untuk memanipulasinya.

public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Public NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Warisan: Object Platform::Object IInspectable StorageFile

Atribut: ContractVersionAttribute

Penerapan: IStorageFile IStorageFile2 IStorageFilePropertiesWithAvailability IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IInputStreamReference IRandomAccessStreamReference

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi	documentsLibrary musicLibrary picturesLibrary videosLibrary

Contoh

Contoh ini menunjukkan kepada Anda cara memanggil pemilih file, menggunakan FileOpenPicker.PickSingleFileAsync untuk menangkap dan memproses file yang dipilih pengguna.

var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
    // Store file for future access
    Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
    // The user didn't pick a file
}

Setelah PickSingleFileAsync selesai, file mendapatkan file yang dipilih sebagai StorageFile.

Dalam contoh, openPicker berisi objek FileOpenPicker . Untuk mempelajari selengkapnya tentang menggunakan pemilih file, lihat Membuka file dan folder dengan pemilih.

Selain itu, fileToken mendapatkan pengidentifikasi yang dapat Anda gunakan untuk mengambil file dari FutureAccessList. Untuk mempelajari selengkapnya tentang menyimpan file dan folder sehingga Anda dapat mengaksesnya lagi nanti, lihat FutureAccessList, MostRecentlyUsedList , dan Melacak file dan folder yang baru digunakan.

Keterangan

Biasanya, Anda mengakses objek StorageFile sebagai hasil dari metode asinkron dan/atau panggilan fungsi. Misalnya, kedua metode statis GetFileFromPathAsync dan GetFileFromApplicationUriAsync mengembalikan StorageFile yang mewakili file yang ditentukan.

Selain itu, setiap kali Anda memanggil pemilih file untuk memungkinkan pengguna memilih file (atau file) pemilih file akan mengembalikan file sebagai StorageFile.

Catatan

Objek StorageFile tidak dapat mewakili file yang merupakan jenis file ".lnk", ".url", atau ".wsh".

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
2004	19041	GetFileFromPathForUserAsync

Properti

Attributes	Mendapatkan atribut file.
ContentType	Mendapatkan jenis MIME dari konten file.
DateCreated	Mendapatkan tanggal dan waktu ketika file saat ini dibuat.
DisplayName	Mendapatkan nama yang mudah digunakan untuk file tersebut.
DisplayType	Mendapatkan deskripsi yang mudah digunakan tentang jenis file.
FileType	Mendapatkan jenis (ekstensi nama file) dari file.
FolderRelativeId	Mendapatkan pengidentifikasi untuk file tersebut. ID ini unik untuk hasil kueri atau StorageFolder yang berisi file dan dapat digunakan untuk membedakan antara item yang memiliki nama yang sama.
IsAvailable	Menunjukkan apakah file bersifat lokal, di-cache secara lokal, atau dapat diunduh.
Name	Mendapatkan nama file termasuk ekstensi nama file.
Path	Mendapatkan jalur sistem file lengkap dari file saat ini, jika file memiliki jalur.
Properties	Mendapatkan objek yang menyediakan akses ke properti file terkait konten.
Provider	Mendapatkan objek StorageProvider yang berisi info tentang layanan yang menyimpan file saat ini.

Metode

CopyAndReplaceAsync(IStorageFile)	Mengganti file yang ditentukan dengan salinan file saat ini.
CopyAsync(IStorageFolder)	Membuat salinan file di folder yang ditentukan.
CopyAsync(IStorageFolder, String)	Membuat salinan file di folder yang ditentukan dan mengganti nama salinan.
CopyAsync(IStorageFolder, String, NameCollisionOption)	Membuat salinan file di folder yang ditentukan dan mengganti nama salinan. Metode ini juga menentukan apa yang harus dilakukan jika file dengan nama yang sama sudah ada di folder tujuan.
CreateStreamedFileAsync(String, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)	Membuat StorageFile untuk mewakili aliran data yang ditentukan. Metode ini memungkinkan aplikasi menghasilkan data sesuai permintaan dengan menentukan fungsi yang akan dipanggil saat StorageFile yang mewakili aliran pertama kali diakses.
CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference)	Membuat StorageFile untuk mewakili aliran data dari sumber daya Pengidentifikasi Sumber Daya Seragam (URI) yang ditentukan. Metode ini memungkinkan aplikasi mengunduh data sesuai permintaan saat StorageFile yang mewakili aliran pertama kali diakses.
DeleteAsync()	Menghapus file saat ini.
DeleteAsync(StorageDeleteOption)	Menghapus file saat ini, secara opsional menghapus item secara permanen.
GetBasicPropertiesAsync()	Mendapatkan properti dasar dari file saat ini.
GetFileFromApplicationUriAsync(Uri)	Mendapatkan objek StorageFile untuk mewakili sumber daya aplikasi Pengidentifikasi Sumber Daya Seragam (URI) yang ditentukan. Untuk contoh URI sampel, lihat Memuat gambar dan aset yang disesuaikan untuk skala, tema, kontras tinggi, dan lainnya.
GetFileFromPathAsync(String)	Mendapatkan objek StorageFile untuk mewakili file di jalur yang ditentukan.
GetFileFromPathForUserAsync(User, String)	Mendapatkan objek StorageFile berdasarkan jalur absolut dalam sistem file untuk pengguna tertentu.
GetParentAsync()	Mendapatkan folder induk dari file saat ini.
GetScaledImageAsThumbnailAsync(ThumbnailMode)	Mendapatkan gambar berskala sebagai gambar mini, yang ditentukan oleh tujuan gambar mini.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Mendapatkan gambar berskala sebagai gambar mini, yang ditentukan oleh tujuan gambar mini dan ukuran yang diminta.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Mendapatkan gambar berskala sebagai gambar mini, yang ditentukan oleh tujuan gambar mini, ukuran yang diminta, dan opsi yang ditentukan
GetThumbnailAsync(ThumbnailMode)	Mengambil gambar mini yang disesuaikan untuk file, yang ditentukan oleh tujuan gambar mini.
GetThumbnailAsync(ThumbnailMode, UInt32)	Mengambil gambar mini yang disesuaikan untuk file, yang ditentukan oleh tujuan gambar mini dan ukuran yang diminta.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Mengambil gambar mini yang disesuaikan untuk file, ditentukan oleh tujuan gambar mini, ukuran yang diminta, dan opsi yang ditentukan.
IsEqual(IStorageItem)	Menunjukkan apakah file saat ini sama dengan file yang ditentukan.
IsOfType(StorageItemTypes)	Menentukan apakah StorageFile saat ini cocok dengan nilai StorageItemTypes yang ditentukan.
MoveAndReplaceAsync(IStorageFile)	Memindahkan file saat ini ke lokasi file yang ditentukan dan menggantikan file yang ditentukan di lokasi tersebut.
MoveAsync(IStorageFolder)	Memindahkan file saat ini ke folder yang ditentukan.
MoveAsync(IStorageFolder, String)	Memindahkan file saat ini ke folder yang ditentukan dan mengganti nama file sesuai dengan nama yang diinginkan.
MoveAsync(IStorageFolder, String, NameCollisionOption)	Memindahkan file saat ini ke folder yang ditentukan dan mengganti nama file sesuai dengan nama yang diinginkan. Metode ini juga menentukan apa yang harus dilakukan jika file dengan nama yang sama sudah ada di folder yang ditentukan.
OpenAsync(FileAccessMode)	Membuka aliran akses acak dengan opsi yang ditentukan melalui file yang ditentukan.
OpenAsync(FileAccessMode, StorageOpenOptions)	Membuka aliran akses acak dengan opsi yang ditentukan melalui file yang ditentukan.
OpenReadAsync()	Membuka aliran akses acak melalui file saat ini untuk membaca konten file.
OpenSequentialReadAsync()	Membuka aliran akses berurutan melalui file saat ini untuk membaca konten file.
OpenTransactedWriteAsync()	Membuka aliran akses acak ke file yang dapat digunakan untuk operasi transacted-write.
OpenTransactedWriteAsync(StorageOpenOptions)	Membuka aliran akses acak ke file yang dapat digunakan untuk operasi transacted-write dengan opsi yang ditentukan.
RenameAsync(String)	Mengganti nama file saat ini.
RenameAsync(String, NameCollisionOption)	Mengganti nama file saat ini. Metode ini juga menentukan apa yang harus dilakukan jika item yang ada di lokasi file saat ini memiliki nama yang sama.
ReplaceWithStreamedFileAsync(IStorageFile, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)	Mengganti konten file yang dirujuk oleh objek IStorageFile yang ditentukan dengan aliran data baru. Metode ini memungkinkan aplikasi menghasilkan data sesuai permintaan dengan menentukan fungsi yang akan dipanggil saat StorageFile yang mewakili aliran pertama kali diakses.
ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference)	Mengganti konten file yang dirujuk oleh objek IStorageFile yang ditentukan dengan aliran data baru dari Pengidentifikasi Sumber Daya Seragam (URI) yang ditentukan. Metode ini memungkinkan aplikasi mengunduh data sesuai permintaan saat StorageFile yang mewakili aliran pertama kali diakses. Aliran data diakses melalui StorageFile yang dikembalikan dan data diunduh sesuai permintaan saat StorageFile pertama kali diakses. Mengganti objek IStorageFile yang mewakili file yang ditentukan dengan StorageFile baru yang menyediakan aliran Pengidentifikasi Sumber Daya Seragam (URI) yang ditentukan.

Berlaku untuk