Bir dosyayı Cloud Storage referansına yükledikten sonra, dosya meta verilerini de alıp güncelleyebilirsiniz (ör. içerik türünü güncellemek için). Dosyalar, ek dosya meta verileriyle özel anahtar/değer çiftleri de depolayabilir.
Dosya Meta Verilerini Alma
Dosya meta verileri, ContentDisposition
ve CreationTimeMillis
gibi daha az yaygın olan ö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 bir Cloud Storage referansından alınabilir.
GetMetadataAsync
yöntemini çağırın.
// 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 yükleme işlemi tamamlandıktan sonra dilediğiniz zaman MetadataChange
nesnesi alan UpdateMetadataAsync
yöntemini kullanarak dosya meta verilerini güncelleyebilirsiniz.
Hangi mülklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta veride belirtilen özellikler
güncellendiğinde, diğer tüm ö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ş dize göndererek 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 verileri alma veya güncelleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Örneğin, dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişme izninin olmaması bu nedenler arasındadır. Hatalarla ilgili daha fazla bilgiyi şurada bulabilirsiniz: Hataları İşleme 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 dosyanın uygulamaya özgü verilerini özel meta verilerde saklayabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (ör. Firebase Realtime Database) kullanmanızı önemle tavsiye ederiz.
Dosya Meta Veri Ö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 tıklayın. Cloud Storage'den dosyaları nasıl sileceğinizi öğrenelim.