Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini de alıp güncelleyebilirsiniz (örneğin, içerik türünü güncellemek için). Dosyalar, ek dosya meta verileriyle birlikte özel anahtar/değer çiftlerini de depolayabilir.
Dosya Meta Verilerini Alma
Dosya meta verileri, ContentDisposition
ve CreationTimeMillis
gibi daha az kullanılan bazı özelliklerin yanı sıra Name
, SizeBytes
ve ContentType
(genellikle MIME türü olarak adlandırılır) gibi yaygın özellikleri içerir. Bu meta veriler, GetMetadataAsync
yöntemi kullanılarak bir Cloud Storage 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üncelleme
Dosya meta verilerini, dosya yükleme işlemi tamamlandıktan sonra istediğiniz zaman MetadataChange
nesnesi alan UpdateMetadataAsync
yöntemini kullanarak güncelleyebilirsiniz.
Hangi özelliklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta veride belirtilen özellikler güncellenir, diğer özellikler değiştirilmeden bırakılır.
// 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 ileterek 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ı Giderme
Meta veri alınırken veya güncellenirken, dosyanın mevcut olmaması ya da kullanıcının istenen dosyaya erişim izninin olmaması gibi çeşitli nedenler vardır. Hatalar hakkında daha fazla bilgiyi belgelerin İşleyici Hataları bölümünde bulabilirsiniz.
Özel Meta Veriler
Özel meta verileri Dictionary<string, string>
olarak belirtebilirsiniz.
var newMetadata = new MetadataChange { CustomMetadata = new Dictionary<string, string> { {"location", "Yosemite, CA, USA"}, {"activity", "Hiking"} } }; // UpdateMetadataAsync
Her dosya için uygulamaya özel verileri özel meta verilerde depolayabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (Firebase Realtime Database gibi) kullanmanızı önemle tavsiye ederiz.
Dosya Meta Verisi Özellikleri
Bir dosyadaki meta veri özelliklerinin tam listesini aşağıda bulabilirsiniz:
Özellik | Tür | 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
Dosya yüklemek, indirmek ve güncellemek önemlidir ancak bunları kaldırabilmek de önemlidir. Şimdi Cloud Storage'dan dosya silme işlemini nasıl yapacağınızı öğrenelim.