לאחר העלאת קובץ לעיון ב-Cloud Storage, תוכל גם לקבל ולעדכן את המטא נתונים של הקובץ, למשל כדי לעדכן את סוג התוכן. קבצים יכולים גם לאחסן צמדי מפתח/ערך מותאמים אישית עם מטא נתונים נוספים של קבצים.
קבל מטא נתונים של קבצים
מטא נתונים של קבצים מכילים מאפיינים נפוצים כגון Name
, SizeBytes
ו- ContentType
(המכונה לעתים קרובות סוג MIME) בנוסף לכמה פחות נפוצים כמו ContentDisposition
ו- CreationTimeMillis
. ניתן לאחזר מטא נתונים אלה מהפניה של Cloud Storage באמצעות שיטת 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 } });
עדכן מטא נתונים של קובץ
אתה יכול לעדכן מטא נתונים של קבצים בכל עת לאחר סיום העלאת הקובץ על ידי שימוש בשיטת UpdateMetadataAsync
שלוקחת אובייקט MetadataChange
. עיין ברשימה המלאה למידע נוסף על אילו נכסים ניתן לעדכן. רק המאפיינים שצוינו במטא נתונים מתעדכנים, כל השאר נותרים ללא שינוי.
// 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; } });
אתה יכול למחוק מאפייני מטא נתונים הניתנים לכתיבה על ידי העברת המחרוזת הריקה:
// 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 } });
טיפול בשגיאות
ישנן מספר סיבות מדוע עשויות להתרחש שגיאות בעת קבלת או עדכון של מטא נתונים, כולל הקובץ שאינו קיים, או שלמשתמש אין הרשאה לגשת לקובץ הרצוי. מידע נוסף על שגיאות ניתן למצוא בקטע טיפול בשגיאות במסמכים.
מטא נתונים מותאמים אישית
אתה יכול לציין מטא נתונים מותאמים אישית Dictionary<string, string>
.
var newMetadata = new MetadataChange { CustomMetadata = new Dictionary<string, string> { {"location", "Yosemite, CA, USA"}, {"activity", "Hiking"} } }; // UpdateMetadataAsync
אתה יכול לאחסן נתונים ספציפיים לאפליקציה עבור כל קובץ במטא נתונים מותאמים אישית, אך אנו ממליצים מאוד להשתמש במסד נתונים (כגון Firebase Realtime Database ) כדי לאחסן ולסנכרן סוג זה של נתונים.
מאפייני מטא נתונים של קובץ
רשימה מלאה של מאפייני מטא נתונים בקובץ זמינה להלן:
תכונה | סוּג | ניתן לשינוי ב- MetadataChange |
---|---|---|
Bucket | string | לא |
Generation | string | לא |
MetadataGeneration | string | לא |
Path | string | לא |
Name | string | לא |
SizeBytes | long | לא |
CreationTimeMillis | long | לא |
UpdatedTimeMillis | long | לא |
CacheControl | string | כן |
ContentDisposition | string | כן |
ContentEncoding | string | כן |
ContentLanguage | string | כן |
ContentType | string | כן |
DownloadUrl | Uri | לא |
DownloadUrls | IList<Uri> | לא |
CustomMetadataKeys | IEnumerable<string> | כן |
הצעדים הבאים
העלאה, הורדה ועדכון של קבצים חשובים, אבל גם היכולת להסיר אותם. בואו ללמוד כיצד למחוק קבצים מ-Cloud Storage.