StorageFile Klasse
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 ü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
- 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
|
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
- StorageFolder
- IStorageFile
- IStorageItem
- IRandomAccessStreamReference
- IInputStreamReference
- IStorageItemProperties
- IStorageItemProperties2
- IStorageItem2
- IStorageItemPropertiesWithProvider
- IStorageFilePropertiesWithAvailability
- Serialisieren und Deserialisieren von Datenbeispielen
- Beispiel zum Dateizugriff
Feedback
Feedback senden und anzeigen für