StorageFile.Properties プロパティ

定義

名前空間:

Windows.Storage

ファイルのコンテンツ関連プロパティへのアクセスを提供する オブジェクトを取得します。

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

StorageItemContentProperties Properties();

public StorageItemContentProperties Properties { get; }

var storageItemContentProperties = storageFile.properties;

Public ReadOnly Property Properties As StorageItemContentProperties

プロパティ値

StorageItemContentProperties

ファイルのコンテンツ関連プロパティへのアクセスを提供する オブジェクト。

実装

Properties

例

この例では、StorageFile.Properties を使用してファイルからコンテンツ プロパティまたは指定されたプロパティを取得する方法を示します。

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
}

GetImagePropertiesAsync が完了したら、 imagePropertiesImageProperties オブジェクトを取得します。 さらに、 RetrievePropertiesAsync が完了した後、 extraProperties 指定したプロパティを含むオブジェクトを取得します。

この例では、 には、 file プロパティを取得するファイルを表す StorageFile が含まれています。

注釈

Note

別のアプリ (Microsoft Word など) によって定義されたプロパティ ハンドラーを使用して取得または設定されたプロパティにアクセスできない場合があります。 代わりに、システム インデックスによってサポートされるファイル クエリを使用して、これらのプロパティを取得できます。 詳細については、「 QueryOptions」を参照してください。

プロパティへのアクセスに関するコード サンプルの詳細については、「 ファイル アクセスのサンプル」を参照してください。