IStorageFile Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Datei dar. Stellt Informationen zu der Datei und ihrem Inhalt sowie Möglichkeiten zur Bearbeitung bereit.
Wichtig
Wenn Sie einfach mit Dateien in Ihrer App arbeiten möchten, lesen Sie die StorageFile-Klasse .
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- Abgeleitet
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
| App-Funktionen |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Eigenschaften
| Attributes |
Ruft die Attribute eines Speicherelements ab. (Geerbt von IStorageItem) |
| ContentType |
Ruft den MIME-Typ des Inhalts der Datei ab. |
| DateCreated |
Ruft das Datum und die Uhrzeit ab, zu dem das aktuelle Element erstellt wurde. (Geerbt von IStorageItem) |
| FileType |
Ruft den Typ (Dateinamenerweiterung) der Datei ab. |
| Name |
Ruft den Namen des Elements ab, einschließlich der Dateinamenerweiterung, falls vorhanden. (Geerbt von IStorageItem) |
| Path |
Ruft den vollständigen Dateisystempfad des Elements ab, wenn das Element über einen Pfad verfügt. (Geerbt von IStorageItem) |
Methoden
| CopyAndReplaceAsync(IStorageFile) |
Ersetzt die angegebene Datei durch eine Kopie der aktuellen Datei. |
| CopyAsync(IStorageFolder) |
Erstellt eine Kopie der Datei im angegebenen Ordner. |
| CopyAsync(IStorageFolder, String) |
Erstellt eine Kopie der Datei im angegebenen Ordner unter Verwendung des gewünschten Namens. |
| CopyAsync(IStorageFolder, String, NameCollisionOption) |
Erstellt eine Kopie der Datei im angegebenen Ordner unter Verwendung des gewünschten Namens. Diese Methode gibt auch an, was zu tun ist, wenn eine vorhandene Datei im angegebenen Ordner denselben Namen hat. |
| DeleteAsync() |
Löscht das aktuelle Element. (Geerbt von IStorageItem) |
| DeleteAsync(StorageDeleteOption) |
Löscht das aktuelle Element und löscht es optional endgültig. (Geerbt von IStorageItem) |
| GetBasicPropertiesAsync() |
Ruft die grundlegenden Eigenschaften des aktuellen Elements ab (z. B. eine Datei oder einen Ordner). (Geerbt von IStorageItem) |
| IsOfType(StorageItemTypes) |
Bestimmt, ob das aktuelle IStorageItem mit dem angegebenen StorageItemTypes-Wert übereinstimmt. (Geerbt von IStorageItem) |
| MoveAndReplaceAsync(IStorageFile) |
Verschiebt die aktuelle Datei an den Speicherort der angegebenen Datei und ersetzt die angegebene Datei an diesem Speicherort. |
| MoveAsync(IStorageFolder) |
Verschiebt die aktuelle Datei in den angegebenen Ordner. |
| MoveAsync(IStorageFolder, String) |
Verschiebt die aktuelle Datei in den angegebenen Ordner und benennt die Datei entsprechend dem gewünschten Namen um. |
| MoveAsync(IStorageFolder, String, NameCollisionOption) |
Verschiebt die aktuelle Datei in den angegebenen Ordner und benennt die Datei entsprechend dem gewünschten Namen um. Diese Methode gibt auch an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im angegebenen Ordner vorhanden ist. |
| OpenAsync(FileAccessMode) |
Öffnet einen Datenstrom mit zufälligem Zugriff über die Datei. |
| OpenReadAsync() |
Öffnet einen Stream für den zufälligen Zugriff. (Geerbt von IRandomAccessStreamReference) |
| OpenSequentialReadAsync() |
Öffnet einen Stream für den sequenziellen Lesezugriff. (Geerbt von IInputStreamReference) |
| OpenTransactedWriteAsync() |
Öffnet einen transaktionsbasierten Datenstrom mit zufälligem Zugriff zum Schreiben in die Datei. |
| RenameAsync(String) |
Benennt das aktuelle Element um. (Geerbt von IStorageItem) |
| RenameAsync(String, NameCollisionOption) |
Benennt das aktuelle Element um. Diese Methode gibt auch an, was zu tun ist, wenn ein vorhandenes Element am Speicherort des aktuellen Elements denselben Namen hat. (Geerbt von IStorageItem) |