Freigeben über


BasicProperties Klasse

Definition

Bietet Zugriff auf die grundlegenden Eigenschaften des Elements (z. B. die Größe des Elements oder das Datum der letzten Änderung des Elements) des Elements (z. B. eine Datei oder einen Ordner).

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

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Dateizugriffsbeispiel veranschaulicht, wie Eigenschaften einer Datei abgerufen werden, einschließlich grundlegender Eigenschaften wie Size und 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
}

Ruft nach Abschluss basicProperties von GetBasicPropertiesAsync ein BasicProperties-Objekt ab.

Enthält im Beispiel eine StorageFile-Datei, die die Datei darstellt, file für die Eigenschaften abgerufen werden sollen.

Hinweise

Sie können auf ein BasicProperties-Objekt asynchron mit der GetBasicPropertiesAsync-Methode eines Elements (z. B. einer Ordnerdatei) oder synchron mit der BasicProperties-Eigenschaft zugreifen, wenn sie verfügbar ist.

Sie können ein BasicProperties-Objekt mit einer der folgenden Methoden und Eigenschaften abrufen:

Eigenschaften

DateModified

Ruft den Zeitstempel der letzten Änderung der Datei ab.

ItemDate

Ruft das relevanteste Datum für das Element ab.

Size

Ruft die Größe der Datei in Bytes ab.

Methoden

RetrievePropertiesAsync(IIterable<String>)

Ruft die angegebenen Eigenschaften ab, die dem Element zugeordnet sind.

SavePropertiesAsync()

Speichert alle Eigenschaften, die dem Element zugeordnet sind.

SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

Speichert die angegebenen Eigenschaften und Werte, die dem Element zugeordnet sind.

Gilt für:

Weitere Informationen