Nach dem Hochladen einer Datei in eine Cloud Storage-Referenz kannst du auch Folgendes abrufen: und die Metadaten der Datei aktualisieren, um z. B. den Inhaltstyp zu aktualisieren. In Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten gespeichert werden.
Dateimetadaten abrufen
Dateimetadaten enthalten allgemeine Attribute wie Name
, SizeBytes
und
ContentType
(oft als MIME-Typ bezeichnet) zusätzlich zu einigen
weniger häufige als ContentDisposition
und CreationTimeMillis
. Diese Metadaten können mit der Methode GetMetadataAsync
aus einer Cloud Storage-Referenz abgerufen werden.
// Create reference to the file whose metadata we want to retrieve StorageReference forestRef = storageRef.Child("images/forest.jpg"); // Get metadata properties forestRef.GetMetadataAsync().ContinueWithOnMainThread(task => { if (!task.IsFaulted && !task.IsCanceled) { StorageMetadata meta = task.Result; // do stuff with meta } });
Dateimetadaten aktualisieren
Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads mit der Methode UpdateMetadataAsync
aktualisieren, die ein MetadataChange
-Objekt annimmt.
Weitere Informationen dazu, welche Properties aktualisiert werden können, finden Sie in der vollständigen Liste. Nur die in den Metadaten angegebenen Properties werden aktualisiert, alle anderen bleiben unverändert.
// Create reference to the file whose metadata we want to change StorageReference forestRef = storageRef.Child("images/forest.jpg"); // Create file metadata to update var newMetadata = new MetadataChange(); newMetadata.CacheControl = "public,max-age=300"; newMetadata.ContentType = "image/jpeg"; // Update metadata properties forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => { if (!task.IsFaulted && !task.IsCanceled) { // access the updated meta data StorageMetadata meta = task.Result; } });
Sie können beschreibbare Metadaten-Properties löschen, indem Sie den leeren String übergeben:
// Create file metadata to update var newMetadata = new MetadataChange(); newMetadata.ContentType = ""; // Update metadata properties forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => { if (!task.IsFaulted && !task.IsCanceled) { StorageMetadata meta = task.Result; // meta.ContentType should be an empty string now } });
Fehler beheben
Es kann verschiedene Gründe dafür geben, dass beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten. Dazu gehört beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung zum Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehler beheben der Dokumentation.
Benutzerdefinierte Metadaten
Sie können benutzerdefinierte Metadaten als Dictionary<string, string>
angeben.
var newMetadata = new MetadataChange { CustomMetadata = new Dictionary<string, string> { {"location", "Yosemite, CA, USA"}, {"activity", "Hiking"} } }; // UpdateMetadataAsync
App-spezifische Daten für jede Datei lassen sich in benutzerdefinierten Metadaten speichern. empfehlen wir die Verwendung einer Datenbank (z. B. der Firebase Realtime Database), um diese Art von Daten.
Dateimetadateneigenschaften
Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:
Attribut | Typ | Anpassbar in MetadataChange |
---|---|---|
Bucket |
string |
NEIN |
Generation |
string |
NEIN |
MetadataGeneration |
string |
NEIN |
Path |
string |
NEIN |
Name |
string |
NEIN |
SizeBytes |
long |
NEIN |
CreationTimeMillis |
long |
NEIN |
UpdatedTimeMillis |
long |
NEIN |
CacheControl |
string |
YES |
ContentDisposition |
string |
YES |
ContentEncoding |
string |
YES |
ContentLanguage |
string |
YES |
ContentType |
string |
YES |
DownloadUrl |
Uri |
NEIN |
DownloadUrls |
IList<Uri> |
NEIN |
CustomMetadataKeys |
IEnumerable<string> |
YES |
Nächste Schritte
Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch die Möglichkeit, sie zu entfernen. Sehen wir uns an, wie Sie Dateien in Cloud Storage löschen.