StorageItemContentProperties クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アイテムのコンテンツ関連のプロパティ (ファイルやフォルダーなど) へのアクセスを提供します。
public ref class StorageItemContentProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemContentProperties final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemContentPropertiesPublic NotInheritable Class StorageItemContentProperties- 継承
- 属性
- 実装
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
例
この例では、 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 が完了すると、imageProperties は ImageProperties オブジェクトを取得します。 さらに、 RetrievePropertiesAsync が完了すると、 extraProperties は指定されたプロパティを含むオブジェクトを取得します (サポートされているプロパティの一覧は、[ コア プロパティ] ページにあります)。
この例では、 file には、プロパティを取得するファイルを表す StorageFile が含まれています。
注釈
StorageItemContentProperties オブジェクトは、次のオブジェクトで使用できる Properties プロパティを使用して取得できます。
- StorageFile.Properties プロパティ
- StorageFolder.Properties プロパティ
- FileInformation.Properties プロパティ
- FolderInformation.Properties プロパティ
Note
別のアプリ (Microsoft Word など) によって定義されたプロパティ ハンドラーを使用して取得または設定されたプロパティにアクセスできない場合があります。 代わりに、システム インデックスによってサポートされるファイル クエリを使用して、これらのプロパティを取得できます。 詳細については、「 QueryOptions」を参照してください。
プロパティへのアクセスに関するコード サンプルの詳細については、「 ファイル アクセスのサンプル」を参照してください。
メソッド
| GetDocumentPropertiesAsync() |
アイテムのドキュメント プロパティ (フォルダーのファイルなど) を取得します。 |
| GetImagePropertiesAsync() |
アイテムのイメージ プロパティ (フォルダーのファイルなど) を取得します。 |
| GetMusicPropertiesAsync() |
アイテムの music プロパティ (フォルダーのファイルなど) を取得します。 |
| GetVideoPropertiesAsync() |
アイテムのビデオ プロパティ (フォルダーのファイルなど) を取得します。 |
| RetrievePropertiesAsync(IIterable<String>) |
アイテムに関連付けられている指定したプロパティを取得します。 |
| SavePropertiesAsync() |
アイテムに関連付けられているすべてのプロパティを保存します。 |
| SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
アイテムに関連付けられている指定したプロパティと値を保存します。 |