Bulut depolama referansına bir dosya yükledikten sonra, örneğin içerik türünü güncellemek için dosya meta verilerini alıp güncelleyebilirsiniz. Dosyalar ayrıca ek dosya meta verileri ile özel anahtar/değer çiftlerini de depolayabilir.
Dosya Meta Verileri Alın
Dosya meta verileri, ContentDisposition
ve CreationTimeMillis
gibi daha az yaygın olanlara ek olarak Name
, SizeBytes
ve ContentType
(genellikle mime türü olarak adlandırılır) gibi ortak özellikler içerir. Bu meta veriler, GetMetadataAsync
yöntemi kullanılarak bir bulut depolama referansından alınabilir.
// 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 } });
Dosya meta verilerini güncelleyin
Dosya Yüklemesi tamamlandıktan sonra herhangi bir zamanda, MetadataChange
nesnesini alan UpdateMetadataAsync
yöntemini kullanarak dosya meta verilerini güncelleyebilirsiniz. Hangi özelliklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta verilerde belirtilen özellikler güncellenir, diğerleri değiştirilmez.
// 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; } });
Boş dizeyi geçerek yazılabilir meta veri özelliklerini silebilirsiniz:
// 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 } });
Hataları İşle
Meta verileri almanın veya güncellemede, mevcut olmayan dosya veya kullanıcının istenen dosyaya erişme izni olmaması için hataların oluşmasının veya güncellenmesinin birkaç nedeni vardır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları İşleme bölümünde bulabilirsiniz.
Özel Meta Veriler
Özel meta verileri bir Dictionary<string, string>
.
var newMetadata = new MetadataChange { CustomMetadata = new Dictionary<string, string> { {"location", "Yosemite, CA, USA"}, {"activity", "Hiking"} } }; // UpdateMetadataAsync
Her dosya için uygulamaya özgü verileri özel meta verilerde depolayabilirsiniz, ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı ( Firebase RealTime veritabanı gibi) kullanmanızı şiddetle tavsiye ederiz.
Dosya Meta Veri Özellikleri
Bir dosyadaki meta veri özelliklerinin tam listesi aşağıda mevcuttur:
Mülk | Tip | MetaDatachange'de Değiştirilebilir |
---|---|---|
Bucket | string | HAYIR |
Generation | string | HAYIR |
MetadataGeneration | string | HAYIR |
Path | string | HAYIR |
Name | string | HAYIR |
SizeBytes | long | HAYIR |
CreationTimeMillis | long | HAYIR |
UpdatedTimeMillis | long | HAYIR |
CacheControl | string | EVET |
ContentDisposition | string | EVET |
ContentEncoding | string | EVET |
ContentLanguage | string | EVET |
ContentType | string | EVET |
DownloadUrl | Uri | HAYIR |
DownloadUrls | IList<Uri> | HAYIR |
CustomMetadataKeys | IEnumerable<string> | EVET |
Sonraki adımlar
Dosyaları yüklemek, indirmek ve güncellemek önemlidir, ancak bunları kaldırabilmektedir. Dosyaları bulut depolama alanından nasıl sileceğinizi öğrenelim.