Setelah mengupload file ke referensi Cloud Storage, Anda juga dapat mengambil dan memperbarui metadata file, misalnya untuk memperbarui jenis konten. File juga dapat menyimpan key-value pair kustom dengan metadata file tambahan.
Mengambil Metadata File
Metadata file berisi properti umum, seperti Name
, SizeBytes
, dan
ContentType
(sering disebut jenis MIME), serta beberapa properti yang
jarang digunakan, seperti ContentDisposition
dan CreationTimeMillis
. Metadata ini dapat diambil dari referensi Cloud Storage menggunakan metode GetMetadataAsync
.
// 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 } });
Memperbarui Metadata File
Anda dapat memperbarui metadata file kapan saja setelah selesai mengupload file menggunakan metode UpdateMetadataAsync
yang mengambil objek MetadataChange
.
Lihat daftar lengkap untuk mengetahui informasi lebih lanjut mengenai
properti yang dapat diperbarui. Hanya properti yang ditetapkan dalam metadata yang akan diperbarui, sedangkan yang lainnya tidak berubah.
// 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; } });
Anda dapat menghapus properti metadata yang dapat ditulis dengan meneruskan string kosong:
// 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 } });
Menangani Error
Ada sejumlah alasan terjadinya error saat mengambil atau memperbarui metadata, termasuk tidak adanya file atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut mengenai error bisa dilihat di bagian Menangani Error pada dokumentasi.
Metadata Kustom
Anda dapat menentukan metadata kustom sebagai Dictionary<string, string>
.
var newMetadata = new MetadataChange { CustomMetadata = new Dictionary<string, string> { {"location", "Yosemite, CA, USA"}, {"activity", "Hiking"} } }; // UpdateMetadataAsync
Anda dapat menyimpan data khusus aplikasi untuk setiap file di metadata kustom, tetapi sebaiknya Anda menggunakan database (seperti Firebase Realtime Database) untuk menyimpan dan menyinkronkan jenis data seperti ini.
Properti Metadata File
Daftar lengkap properti metadata pada file tercantum di bawah ini:
Properti | Jenis | Dapat Diubah di MetadataChange |
---|---|---|
Bucket |
string |
TIDAK |
Generation |
string |
TIDAK |
MetadataGeneration |
string |
TIDAK |
Path |
string |
TIDAK |
Name |
string |
TIDAK |
SizeBytes |
long |
TIDAK |
CreationTimeMillis |
long |
TIDAK |
UpdatedTimeMillis |
long |
TIDAK |
CacheControl |
string |
YA |
ContentDisposition |
string |
YA |
ContentEncoding |
string |
YA |
ContentLanguage |
string |
YA |
ContentType |
string |
YA |
DownloadUrl |
Uri |
TIDAK |
DownloadUrls |
IList<Uri> |
TIDAK |
CustomMetadataKeys |
IEnumerable<string> |
YA |
Langkah Berikutnya
Mengupload, mendownload, dan memperbarui file itu penting, tetapi kita juga harus bisa menghapusnya. Mari pelajari cara menghapus file dari Cloud Storage.