StorageFile Klasse

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 über die Datei und ihren Inhalt sowie Möglichkeiten bereit, 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 Platform::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 von den Benutzern ausgewählt wird.

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
}

Ruft nach Abschluss file von PickSingleFileAsync 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 darüber hinaus einen Bezeichner ab, fileToken mit dem Sie die Datei aus futureAccessList abrufen können. Weitere Informationen zum Speichern von Dateien und Ordnern, damit Sie später wieder darauf zugreifen können, finden Sie unter FutureAccessList, MostRecentlyUsedList und Nachverfolgen zuletzt verwendeter Dateien und Ordner.

Hinweise

In der Regel greifen Sie als Ergebnis asynchroner Methoden- und/oder Funktionsaufrufe auf StorageFile-Objekte zu. Beispielsweise geben die beiden statischen Methoden GetFileFromPathAsync und GetFileFromApplicationUriAsync eine StorageFile zurück, die die angegebene Datei darstellt.

Darüber hinaus gibt die Dateiauswahl, wenn Sie eine Dateiauswahl aufrufen, um dem Benutzer die Auswahl einer Datei (oder Dateien) zu ermöglichen, die Datei als StorageFile zurück.

Hinweis

StorageFile-Objekte können keine Dateien darstellen, die die Dateitypen ".lnk", ".url" oder ".wsh" 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 Dateityps ab.
FileType	Ruft den Typ (Dateinamenerweiterung) der Datei ab.
FolderRelativeId	Ruft einen Bezeichner für die Datei ab. Diese ID ist eindeutig für das Abfrageergebnis oder StorageFolder , das die Datei enthält, und kann verwendet werden, um zwischen Elementen mit demselben Namen zu unterscheiden.
IsAvailable	Gibt an, ob die Datei lokal ist, lokal zwischengespeichert wird oder heruntergeladen werden kann.
Name	Ruft den Namen der Datei einschließlich der Dateinamenerweiterung ab.
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 zu dem 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-Datei , die den angegebenen Datenstrom darstellt. Mit dieser Methode kann die App die Daten bei Bedarf erstellen, indem eine Funktion angegeben wird, die aufgerufen werden soll, wenn zuerst auf die StorageFile , die den Stream darstellt, zugegriffen wird.
CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference)	Erstellt eine StorageFile-Datei , die einen Datenstrom aus der angegebenen URI-Ressource (Uniform Resource Identifier) darstellt. Mit dieser Methode kann die App die Daten bei Bedarf herunterladen, wenn zuerst auf die StorageFile zugegriffen wird, die den Stream darstellt.
DeleteAsync()	Löscht die aktuelle Datei.
DeleteAsync(StorageDeleteOption)	Löscht die aktuelle Datei und löscht optional das Element dauerhaft.
GetBasicPropertiesAsync()	Ruft die grundlegenden Eigenschaften der aktuellen Datei ab.
GetFileFromApplicationUriAsync(Uri)	Ruft ein StorageFile-Objekt ab, das die angegebene URI-App-Ressource (Uniform Resource Identifier) darstellt. 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, das die Datei am angegebenen Pfad darstellt.
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 vom Zweck der Miniaturansicht bestimmt wird.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht und der angeforderten Größe bestimmt wird.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Ruft ein skaliertes Bild als Miniaturansicht ab, die vom Zweck der Miniaturansicht, der angeforderten Größe und den angegebenen Optionen bestimmt wird.
GetThumbnailAsync(ThumbnailMode)	Ruft ein angepasstes Miniaturbild für die Datei ab, das vom Zweck der Miniaturansicht bestimmt wird.
GetThumbnailAsync(ThumbnailMode, UInt32)	Ruft ein angepasstes Miniaturbild für die Datei ab, das vom Zweck der Miniaturansicht und der angeforderten 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 mit dem angegebenen StorageItemTypes-Wert übereinstimmt.
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 mit den angegebenen Optionen für die angegebene Datei.
OpenAsync(FileAccessMode, StorageOpenOptions)	Öffnet einen Datenstrom mit zufälligem Zugriff mit den angegebenen Optionen für die angegebene Datei.
OpenReadAsync()	Öffnet einen Datenstrom mit zufälligem Zugriff über die aktuelle Datei zum Lesen von Dateiinhalten.
OpenSequentialReadAsync()	Öffnet einen Datenstrom mit sequenziellem Zugriff über die aktuelle Datei zum Lesen von Dateiinhalten.
OpenTransactedWriteAsync()	Öffnet einen Datenstrom mit zufälligem Zugriff auf die Datei, die für Transacted-Write-Vorgänge verwendet werden kann.
OpenTransactedWriteAsync(StorageOpenOptions)	Öffnet einen Datenstrom mit zufälligem Zugriff auf die Datei, die für Transacted-Write-Vorgä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 erstellen, indem eine Funktion angegeben wird, die aufgerufen werden soll, wenn zuerst auf die StorageFile , die den Stream darstellt, zugegriffen wird.
ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference)	Ersetzt den Inhalt der Datei, auf die durch das angegebene IStorageFile-Objekt verwiesen wird, durch einen neuen Datenstrom des angegebenen URI (Uniform Resource Identifier). Mit dieser Methode kann die App die Daten bei Bedarf herunterladen, wenn zuerst auf die StorageFile zugegriffen wird, die den Stream darstellt. Auf den Datenstrom wird über die zurückgegebene StorageFile-Datei zugegriffen, und die Daten werden bei Bedarf heruntergeladen, wenn zum ersten Mal auf die StorageFile zugegriffen wird. Ersetzt das IStorageFile-Objekt , das die angegebene Datei darstellt, durch eine neue StorageFile , die einen Stream des angegebenen URI (Uniform Resource Identifier) bereitstellt.

Gilt für: