BasicProperties Kelas

Referensi

Definisi

Ruang nama:: Windows.Storage.FileProperties

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

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: Object Platform::Object IInspectable BasicProperties

Atribut: ContractVersionAttribute

Penerapan: IStorageItemExtraProperties

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:

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

Bagikan melalui