StorageFile.Properties Eigenschaft

Definition

Namespace:

Windows.Storage

Ruft ein -Objekt ab, das Zugriff auf die inhaltsbezogenen Eigenschaften der Datei ermöglicht.

public:
 property StorageItemContentProperties ^ Properties { StorageItemContentProperties ^ get(); };

StorageItemContentProperties Properties();

public StorageItemContentProperties Properties { get; }

var storageItemContentProperties = storageFile.properties;

Public ReadOnly Property Properties As StorageItemContentProperties

Eigenschaftswert

StorageItemContentProperties

Das -Objekt, das Zugriff auf die inhaltsbezogenen Eigenschaften der Datei ermöglicht.

Implementiert

Properties

Beispiele

In diesem Beispiel wird veranschaulicht, wie Inhaltseigenschaften oder angegebene Eigenschaften mithilfe von StorageFile.Properties aus einer Datei abgerufen werden.

try
{
    StorageFile file = rootPage.sampleFile;
       if (file != null)
       {
        StringBuilder outputText = new StringBuilder();

           // Get image properties
              ImageProperties imageProperties = await file.Properties.GetImagePropertiesAsync();
              outputText.AppendLine("Date taken: " + imageProperties.DateTaken);
              outputText.AppendLine("Rating: " + imageProperties.Rating);

              // 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 imagePropertiesvon GetImagePropertiesAsync ein ImageProperties-Objekt ab. Außerdem ruft nach Abschluss von RetrievePropertiesAsync ein Objekt ab, extraProperties das die angegebenen Eigenschaften enthält.

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

Hinweise

Hinweis

Auf Eigenschaften, die mithilfe eines Eigenschaftenhandlers abgerufen oder festgelegt werden, der von einer anderen App (z. B. Microsoft Word) definiert wird, kann möglicherweise nicht zugegriffen werden. Stattdessen können Sie versuchen, diese Eigenschaften mithilfe einer Dateiabfrage abzurufen, die vom Systemindex unterstützt wird. Weitere Informationen finden Sie unter QueryOptions.

Weitere Codebeispiele zum Zugreifen auf Eigenschaften finden Sie im Dateizugriffsbeispiel.