IStorageFile Schnittstelle

Referenz

Definition

Namespace:: Windows.Storage

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.

Bearbeiten

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: Windows.Storage.BulkAccess.FileInformation

Windows.Storage.StorageFile

Attribute: ContractVersionAttribute GuidAttribute

Implementiert: IStorageItem IInputStreamReference IRandomAccessStreamReference

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: