Freigeben über


IStorageFile Schnittstelle

Definition

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, IRandomAccessStreamReference
Public 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)

Gilt für:

Weitere Informationen