情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。
このトピックはまだ評価されていません - このトピックを評価する

StorageFile Class

ファイルを表します。ファイルとそのコンテンツについての情報、およびその操作方法を提供します。

構文


/* このオブジェクトの作成とアクセスについて詳しくは、注釈をご覧ください。 */

属性

[Muse()]
[Version(0x06020000)]

メンバー

StorageFileクラス には次の種類のメンバーが含まれます:

メソッド

The StorageFile クラス には次のメソッドがあります。C#、Visual Basic、C++ では、次のもののメソッドも継承しますObject クラス.

メソッド説明
CopyAndReplaceAsync Replaces the specified file with a copy of the current file.
CopyAsync(IStorageFolder) Creates a copy of the file in the specified folder.
CopyAsync(IStorageFolder, String) Creates a copy of the file in the specified folder, using the desired name.
CopyAsync(IStorageFolder, String, NameCollisionOption) Creates a copy of the file in the specified folder, using the desired name. This method also specifies what to do if an existing file in the specified folder has the same name.
CreateStreamedFileAsync Creates a StorageFile to represent the specified stream of data. This method lets the app produce the data on-demand by specifying a function to be invoked when the StorageFile that represents the stream is first accessed.
CreateStreamedFileFromUriAsync Creates a StorageFile to represent a stream of data from the specified Uniform Resource Identifier (URI) resource. This method lets the app download the data on-demand when the StorageFile that represents the stream is first accessed.
DeleteAsync() Deletes the current file.
DeleteAsync(StorageDeleteOption) Deletes the current file, optionally deleting the item permanently.
GetBasicPropertiesAsync Gets the basic properties of the current file.
GetFileFromApplicationUriAsync Gets a StorageFile object to represent the specified Uniform Resource Identifier (URI) app resource.
GetFileFromPathAsync Gets a StorageFile object to represent the file at the specified path.
GetParentAsync Gets the parent folder of the current file.
GetScaledImageAsThumbnailAsync(ThumbnailMode) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail and the requested size.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail, the requested size, and the specified options
GetThumbnailAsync(ThumbnailMode) Retrieves an adjusted thumbnail image for the file, determined by the purpose of the thumbnail.
GetThumbnailAsync(ThumbnailMode, UInt32) Retrieves an adjusted thumbnail image for the file, determined by the purpose of the thumbnail and the requested size.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Retrieves an adjusted thumbnail image for the file, determined by the purpose of the thumbnail, the requested size, and the specified options.
IsEqual Indicates whether the current file is equal to the specified file.
IsOfType Determines whether the current StorageFile matches the specified StorageItemTypes value.
MoveAndReplaceAsync Moves the current file to the location of the specified file and replaces the specified file in that location.
MoveAsync(IStorageFolder) Moves the current file to the specified folder.
MoveAsync(IStorageFolder, String) Moves the current file to the specified folder and renames the file according to the desired name.
MoveAsync(IStorageFolder, String, NameCollisionOption) Moves the current file to the specified folder and renames the file according to the desired name. This method also specifies what to do if a file with the same name already exists in the specified folder.
OpenAsync Opens a random-access stream over the file.
OpenReadAsync Opens a random-access stream over the current file for reading file contents.
OpenSequentialReadAsync Opens a sequential-access stream over the current file for reading file contents.
OpenTransactedWriteAsync Opens a random-access stream to the file that can be used for transacted-write operations.
RenameAsync(String) Renames the current file.
RenameAsync(String, NameCollisionOption) Renames the current file. This method also specifies what to do if an existing item in the current file's location has the same name.
ReplaceWithStreamedFileAsync Replaces the contents of the file referred to by the specified IStorageFile object with a new data stream. This method lets the app produce the data on-demand by specifying a function to be invoked when the StorageFile that represents the stream is first accessed.
ReplaceWithStreamedFileFromUriAsync Replaces the contents of the file referred to by the specified IStorageFile object with a new data stream of the specified Uniform Resource Identifier (URI). This method lets the app download the data on-demand when the StorageFile that represents the stream is first accessed.

 

プロパティ

StorageFileクラス次のプロパティがあります。

プロパティアクセスの種類説明

Attributes

読み取り専用Gets the attributes of a file.

ContentType

読み取り専用Gets the MIME type of the contents of the file.

DateCreated

読み取り専用Gets the date and time when the current file was created.

DisplayName

読み取り専用Gets a user-friendly name for the file.

DisplayType

読み取り専用Gets a user-friendly description of the type of the file.

FileType

読み取り専用Gets the type (file name extension) of the file.

FolderRelativeId

読み取り専用Gets an identifier for the file. This ID is unique for the query result or StorageFolder that contains the file and can be used to distinguish between items that have the same name.

IsAvailable

読み取り専用Indicates if the file is local, is cached locally, or can be downloaded.

Name

読み取り専用Gets the name of the file including the file name extension.

Path

読み取り専用Gets the full file-system path of the current file, if the file has a path.

Properties

読み取り専用Gets an object that provides access to the content-related properties of the file.

Provider

読み取り専用Gets the StorageProvider object that contains info about the service that stores the current file.

 

注釈

通常、非同期メソッドまたは関数呼び出しの結果として StorageFile オブジェクトにアクセスします。たとえば、静的メソッド GetFileFromPathAsync および GetFileFromApplicationUriAsync は、両方とも、指定したファイルを表す StorageFile を返します。

また、ファイル ピッカーを呼び出して 1 つまたは複数のファイルを選択した場合、ピッカーは常に StorageFile としてファイルを返します。

  StorageFile オブジェクトで、ファイルの種類が ".lnk"、".url"、または ".wsh" であるファイルを表すことはできません。

この例では、FileOpenPicker.PickSingleFileAsync を使用してファイル ピッカーを呼び出し、ユーザーが選択するファイルをキャプチャして処理する方法を示します。



openPicker.pickSingleFileAsync().then(function (file) {
   if (file) {
       // Process picked file

       // Store file for future access
       var fileToken = Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.add(file);
   } else {
       // The user didn't pick a file
   }
});

PickSingleFileAsync が完了すると、file は、選択ファイルを StorageFile として取得します。

例では、openPickerFileOpenPicker オブジェクトが含まれます。ファイル ピッカーの使用方法の詳細については、「FileOpenPicker」と「クイック スタート: ファイル ピッカーによるファイルへのアクセス」を参照してください。

また、fileTokenFutureAccessList からファイルを取得するために使用できる識別子を取得します。後でアクセスできるようにファイルおよびフォルダーを保存することに関する詳細については、「FutureAccessList」、「MostRecentlyUsedList」、「How to track recently used files and folders (最近使用されたファイルとフォルダーの追跡方法)」を参照してください。

要件

サポートされている最小のクライアント

Windows 8 [Windows ストア アプリのみ]

サポートされている最小のサーバー

Windows Server 2012 [Windows ストア アプリのみ]

サポートされている最小の電話

Windows Phone 8

名前空間

Windows.Storage
Windows::Storage [C++]

メタデータ

Windows.winmd

Capabilities

picturesLibrary
videosLibrary
musicLibrary
documentsLibrary

参照

StorageFolder
IStorageFile
IStorageItem
IRandomAccessStreamReference
IInputStreamReference
IStorageItemProperties
IStorageItemProperties2
IStorageItem2
IStorageItemPropertiesWithProvider
IStorageFilePropertiesWithAvailability

 

 

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft. All rights reserved.