BasicProperties Klasse

Referenz

Definition

Namespace:: Windows.Storage.FileProperties

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute

Implementiert: IStorageItemExtraProperties

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: