IStorageFile Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un fichier. Fournit des informations sur le fichier et son contenu, ainsi que sur les façons de les manipuler.
Important
Si vous souhaitez simplement utiliser des fichiers dans votre application, consultez la classe StorageFile .
public interface class IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(4198457734, 16916, 17036, 166, 76, 20, 201, 172, 115, 21, 234)]
struct IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(4198457734, 16916, 17036, 166, 76, 20, 201, 172, 115, 21, 234)]
public interface IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReferencePublic Interface IStorageFile
Implements IInputStreamReference, IRandomAccessStreamReference, IStorageItem- Dérivé
- Attributs
- Implémente
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
| Fonctionnalités de l’application |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Propriétés
| Attributes |
Obtient les attributs d’un élément de stockage. (Hérité de IStorageItem) |
| ContentType |
Obtient le type MIME du contenu du fichier. |
| DateCreated |
Obtient la date et l’heure de création de l’élément actif. (Hérité de IStorageItem) |
| FileType |
Obtient le type (extension de nom de fichier) du fichier. |
| Name |
Obtient le nom de l’élément, y compris l’extension de nom de fichier le cas échéant. (Hérité de IStorageItem) |
| Path |
Obtient le chemin d’accès complet du système de fichiers de l’élément, si l’élément a un chemin d’accès. (Hérité de IStorageItem) |
Méthodes
| CopyAndReplaceAsync(IStorageFile) |
Remplace le fichier spécifié par une copie du fichier actif. |
| CopyAsync(IStorageFolder) |
Crée une copie du fichier dans le dossier spécifié. |
| CopyAsync(IStorageFolder, String) |
Crée une copie du fichier dans le dossier spécifié, en utilisant le nom souhaité. |
| CopyAsync(IStorageFolder, String, NameCollisionOption) |
Crée une copie du fichier dans le dossier spécifié, en utilisant le nom souhaité. Cette méthode spécifie également ce qu’il faut faire si un fichier existant dans le dossier spécifié porte le même nom. |
| DeleteAsync() |
Supprime l’élément actif. (Hérité de IStorageItem) |
| DeleteAsync(StorageDeleteOption) |
Supprime l’élément actif, éventuellement en le supprimant définitivement. (Hérité de IStorageItem) |
| GetBasicPropertiesAsync() |
Obtient les propriétés de base de l’élément actif (comme un fichier ou un dossier). (Hérité de IStorageItem) |
| IsOfType(StorageItemTypes) |
Détermine si l’objet IStorageItem actuel correspond à la valeur StorageItemTypes spécifiée. (Hérité de IStorageItem) |
| MoveAndReplaceAsync(IStorageFile) |
Déplace le fichier actif vers l’emplacement du fichier spécifié et remplace le fichier spécifié à cet emplacement. |
| MoveAsync(IStorageFolder) |
Déplace le fichier actif vers le dossier spécifié. |
| MoveAsync(IStorageFolder, String) |
Déplace le fichier actif vers le dossier spécifié et renomme le fichier en fonction du nom souhaité. |
| MoveAsync(IStorageFolder, String, NameCollisionOption) |
Déplace le fichier actif vers le dossier spécifié et renomme le fichier en fonction du nom souhaité. Cette méthode spécifie également ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier spécifié. |
| OpenAsync(FileAccessMode) |
Ouvre un flux d’accès aléatoire sur le fichier. |
| OpenReadAsync() |
Ouvre un flux pour un accès aléatoire. (Hérité de IRandomAccessStreamReference) |
| OpenSequentialReadAsync() |
Ouvre un flux pour l’accès en lecture séquentiel. (Hérité de IInputStreamReference) |
| OpenTransactedWriteAsync() |
Ouvre un flux d’accès aléatoire traité pour l’écriture dans le fichier. |
| RenameAsync(String) |
Renomme l’élément actif. (Hérité de IStorageItem) |
| RenameAsync(String, NameCollisionOption) |
Renomme l’élément actif. Cette méthode spécifie également ce qu’il faut faire si un élément existant à l’emplacement de l’élément actif porte le même nom. (Hérité de IStorageItem) |