StorageFile Klasse

  • Referenz

Definition

Namespace:
Windows.Storage
Bearbeiten

Stellt eine Datei dar. Stellt Informationen über die Datei und deren Inhalt bereit und bietet Möglichkeiten, sie zu bearbeiten.

public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
Public NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
Vererbung
Object IInspectable StorageFile
Attribute
ContractVersionAttribute
Implementiert
IStorageFile IStorageFile2 IStorageFilePropertiesWithAvailability IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider 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

Beispiele

In diesem Beispiel wird gezeigt, wie Sie eine Dateiauswahl aufrufen, indem Sie FileOpenPicker.PickSingleFileAsync verwenden, um eine Datei zu erfassen und zu verarbeiten, die die Benutzer auswählen.

var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
    // Store file for future access
    Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
    // The user didn't pick a file
}

Nachdem PickSingleFileAsync abgeschlossen wurde, file ruft die ausgewählte Datei als StorageFile ab.

Enthält im Beispiel openPicker ein FileOpenPicker-Objekt . Weitere Informationen zur Verwendung der Dateiauswahl finden Sie unter Öffnen von Dateien und Ordnern mit einer Auswahl.

Ruft außerdem einen Bezeichner ab, fileToken mit dem Sie die Datei aus der FutureAccessList abrufen können. Weitere Informationen zum Speichern von Dateien und Ordnern, damit Sie später erneut darauf zugreifen können, finden Sie unter FutureAccessList, MostRecentlyUsedList und Nachverfolgen zuletzt verwendeter Dateien und Ordner.

Hinweise

Normalerweise greifen Sie auf StorageFile-Objekte als Ergebnis asynchroner Methoden- und/oder Funktionsaufrufe zu. Beispielsweise geben beide statische Methoden GetFileFromPathAsync und GetFileFromApplicationUriAsync eine StorageFile zurück, die die angegebene Datei darstellt.

Immer dann, wenn Sie eine Dateiauswahl aufrufen, damit der Benutzer eine Datei (oder Dateien) auswählen kann, gibt die Dateiauswahl die Datei als StorageFile zurück.

Hinweis

StorageFile-Objekte können keine Dateien darstellen, die ".lnk", ".url" oder ".wsh" Dateitypen sind.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
2004 19041 GetFileFromPathForUserAsync

Eigenschaften

Attributes

Ruft die Attribute einer Datei ab.
ContentType

Ruft den MIME-Typ des Inhalts der Datei ab.
DateCreated

Ruft das Datum und die Uhrzeit der Erstellung der aktuellen Datei ab.
DisplayName

Ruft einen benutzerfreundlichen Namen für die Datei ab.
DisplayType

Ruft eine benutzerfreundliche Beschreibung des Typs der Datei ab.
FileType

Ruft den Typ (Dateinamenerweiterung) der Datei ab.
FolderRelativeId

Ruft einen Bezeichner für die Datei ab. Diese ID ist für das Abfrageergebnis oder StorageFolder eindeutig, das die Datei enthält, und kann verwendet werden, um zwischen Elementen zu unterscheiden, die denselben Namen haben.
IsAvailable

Gibt an, ob die Datei lokal ist, lokal zwischengespeichert oder heruntergeladen werden kann.
Name

Ruft den Namen der Datei ab, einschließlich der Dateinamenerweiterung.
Path

Ruft den vollständigen Dateisystempfad der aktuellen Datei ab, wenn die Datei über einen Pfad verfügt.
Properties

Ruft ein Objekt ab, das Zugriff auf die inhaltsbezogenen Eigenschaften der Datei bietet.
Provider

Ruft das StorageProvider -Objekt ab, das Informationen zum Dienst enthält, der die aktuelle Datei speichert.

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 und benennt die Kopie um.
CopyAsync(IStorageFolder, String, NameCollisionOption)

Erstellt eine Kopie der Datei im angegebenen Ordner und benennt die Kopie um. Diese Methode gibt auch an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im Zielordner vorhanden ist.
CreateStreamedFileAsync(String, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)

Erstellt eine StorageFile , um den angegebenen Datenstrom darzustellen. Mit dieser Methode kann die App die Daten bei Bedarf erzeugen, indem eine Funktion angegeben wird, die aufgerufen werden soll, wenn auf die StorageFile , die den Datenstrom darstellt, zuerst zugegriffen wird.
CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference)

Erstellt eine StorageFile , um einen Datenstrom aus der angegebenen URI-Ressource (Uniform Resource Identifier) darzustellen. Mit dieser Methode kann die App die Daten on-Demand herunterladen, wenn auf die StorageFile , die den Datenstrom darstellt, zuerst zugegriffen wird.
DeleteAsync()

Löscht die aktuelle Datei.
DeleteAsync(StorageDeleteOption)

Löscht die aktuelle Datei, optional wird das Element dauerhaft gelöscht.
GetBasicPropertiesAsync()

Ruft die grundlegenden Eigenschaften der aktuellen Datei ab.
GetFileFromApplicationUriAsync(Uri)

Ruft ein StorageFile-Objekt ab, um die angegebene URI-App-Ressource (Uniform Resource Identifier) darzustellen. Beispiele für Beispiel-URIs finden Sie unter Laden von Bildern und Ressourcen, die auf Skalierung, Design, hohen Kontrast und andere zugeschnitten sind.
GetFileFromPathAsync(String)

Ruft ein StorageFile-Objekt ab, um die Datei im angegebenen Pfad darzustellen.
GetFileFromPathForUserAsync(User, String)

Ruft ein StorageFile -Objekt basierend auf einem absoluten Pfad im Dateisystem für einen bestimmten Benutzer ab.
GetParentAsync()

Ruft den übergeordneten Ordner der aktuellen Datei ab.
GetScaledImageAsThumbnailAsync(ThumbnailMode)

Ruft ein skaliertes Bild als Miniaturansicht ab, die durch den Zweck der Miniaturansicht bestimmt wird.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein skaliertes Bild als Miniaturansicht ab, bestimmt durch den Zweck der Miniaturansicht und die angeforderte Größe.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein skaliertes Bild als Miniaturansicht ab, bestimmt durch den Zweck der Miniaturansicht, die angeforderte Größe und die angegebenen Optionen
GetThumbnailAsync(ThumbnailMode)

Ruft ein angepasstes Miniaturbild für die Datei ab, das durch den Zweck der Miniaturansicht bestimmt wird.
GetThumbnailAsync(ThumbnailMode, UInt32)

Ruft ein angepasstes Miniaturbild für die Datei ab, das durch den Zweck der Miniaturansicht und die angeforderte Größe bestimmt wird.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Ruft ein angepasstes Miniaturbild für die Datei ab, das durch den Zweck der Miniaturansicht, die angeforderte Größe und die angegebenen Optionen bestimmt wird.
IsEqual(IStorageItem)

Gibt an, ob die aktuelle Datei gleich der angegebenen Datei ist.
IsOfType(StorageItemTypes)

Bestimmt, ob die aktuelle StorageFile dem angegebenen StorageItemTypes-Wert entspricht.
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 Zufallszugriffsstream mit den angegebenen Optionen für die angegebene Datei.
OpenAsync(FileAccessMode, StorageOpenOptions)

Öffnet einen Zufallszugriffsstream mit den angegebenen Optionen für die angegebene Datei.
OpenReadAsync()

Öffnet einen Zufallszugriffsstream über die aktuelle Datei zum Lesen von Dateiinhalten.
OpenSequentialReadAsync()

Öffnet einen Sequenzzugriffsstream über die aktuelle Datei zum Lesen von Dateiinhalten.
OpenTransactedWriteAsync()

Öffnet einen Zufallszugriffsdatenstrom auf die Datei, die für Transaktionen-Schreibvorgänge verwendet werden kann.
OpenTransactedWriteAsync(StorageOpenOptions)

Öffnet einen Zufallszugriffsdatenstrom auf die Datei, die für Transaktions-Schreibvorgänge mit den angegebenen Optionen verwendet werden kann.
RenameAsync(String)

Benennt die aktuelle Datei um.
RenameAsync(String, NameCollisionOption)

Benennt die aktuelle Datei um. Diese Methode gibt auch an, was zu tun ist, wenn ein vorhandenes Element am Speicherort der aktuellen Datei denselben Namen hat.
ReplaceWithStreamedFileAsync(IStorageFile, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)

Ersetzt den Inhalt der Datei, auf die durch das angegebene IStorageFile-Objekt verwiesen wird, durch einen neuen Datenstrom. Mit dieser Methode kann die App die Daten bei Bedarf erzeugen, indem eine Funktion angegeben wird, die aufgerufen werden soll, wenn auf die StorageFile , die den Datenstrom darstellt, zuerst zugegriffen wird.
ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference)

Ersetzt den Inhalt der Datei, die durch das angegebene IStorageFile-Objekt bezeichnet wird, durch einen neuen Datenstrom des angegebenen URI (Uniform Resource Identifier). Mit dieser Methode kann die App die Daten on-Demand herunterladen, wenn auf die StorageFile , die den Datenstrom darstellt, zuerst zugegriffen wird.

Auf den Datenstrom wird über die zurückgegebene StorageFile zugegriffen, und die Daten werden nach Bedarf heruntergeladen, wenn zuerst auf die StorageFile zugegriffen wird.

Ersetzt das IStorageFile-Objekt , das die angegebene Datei durch eine neue StorageFile darstellt, die einen Stream des angegebenen Uniform Resource Identifier (URI) bereitstellt.

Gilt für

Weitere Informationen