BasicProperties Kelas
Definisi
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.
Menyediakan akses ke properti dasar, seperti ukuran item atau tanggal item terakhir diubah, dari item (seperti file atau folder).
public ref class BasicProperties sealed : IStorageItemExtraProperties
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BasicProperties final : IStorageItemExtraProperties
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BasicProperties : IStorageItemExtraProperties
Public NotInheritable Class BasicProperties
Implements IStorageItemExtraProperties
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Sampel Akses file menunjukkan cara mengambil properti file, termasuk properti dasar seperti Ukuran dan DateModified.
try
{
StorageFile file = rootPage.sampleFile;
if (file != null)
{
StringBuilder outputText = new StringBuilder();
// Get basic properties
BasicProperties basicProperties = await file.GetBasicPropertiesAsync();
outputText.AppendLine("File size: " + basicProperties.Size + " bytes");
outputText.AppendLine("Date modified: " + basicProperties.DateModified);
// Specify more properties to retrieve
readonly string dateAccessedProperty = "System.DateAccessed";
readonly string fileOwnerProperty = "System.FileOwner";
List<string> propertiesName = new List<string>();
propertiesName.Add(dateAccessedProperty);
propertiesName.Add(fileOwnerProperty);
// Get the specified properties through StorageFile.Properties
IDictionary<string, object> extraProperties = await file.Properties.RetrievePropertiesAsync(propertiesName);
var propValue = extraProperties[dateAccessedProperty];
if (propValue != null)
{
outputText.AppendLine("Date accessed: " + propValue);
}
propValue = extraProperties[fileOwnerProperty];
if (propValue != null)
{
outputText.AppendLine("File owner: " + propValue);
}
}
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
// For example, handle a file not found error
}
Setelah GetBasicPropertiesAsync selesai, basicProperties
mendapatkan objek BasicProperties.
Dalam contoh, file
berisi StorageFile yang mewakili file untuk mengambil properti.
Keterangan
Anda dapat mengakses objek BasicProperties secara asinkron menggunakan metode GetBasicPropertiesAsync item (seperti file folder), atau secara sinkron menggunakan properti BasicProperties jika tersedia.
Anda bisa mendapatkan objek BasicProperties menggunakan salah satu metode dan properti berikut:
- metode storageFile.getBasicPropertiesAsync
- metode storageFolder.getBasicPropertiesAsync
- Properti FileInformation.basicProperties
- Properti FolderInformation.basicProperties
Properti
DateModified |
Mendapatkan tanda waktu terakhir kali file dimodifikasi. |
ItemDate |
Mendapatkan tanggal yang paling relevan untuk item. |
Size |
Mendapatkan ukuran file dalam byte. |
Metode
RetrievePropertiesAsync(IIterable<String>) |
Mengambil properti yang ditentukan yang terkait dengan item. |
SavePropertiesAsync() |
Menyimpan semua properti yang terkait dengan item. |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Menyimpan properti dan nilai yang ditentukan yang terkait dengan item. |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk