Bagikan melalui

BasicProperties Kelas

Definisi

Ruang nama:
Windows.Storage.FileProperties
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

Persyaratan Deskripsi
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

Nama Deskripsi
DateModified

Mendapatkan tanda waktu terakhir kali file dimodifikasi.
ItemDate

Mendapatkan tanggal yang paling relevan untuk item.
Size

Mendapatkan ukuran file dalam byte.

Metode

Nama Deskripsi
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