Bagikan melalui


StorageFile Kelas

Definisi

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
Penerapan

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

Lihat juga