Xamarin.Essentials: Pomocnicy systemu plików

Klasa FileSystem zawiera szereg pomocników do znajdowania pamięci podręcznej i katalogów danych aplikacji oraz otwierania plików wewnątrz pakietu aplikacji.

Rozpocznij

Aby rozpocząć korzystanie z tego interfejsu API, przeczytaj przewodnik wprowadzający , Xamarin.Essentials aby upewnić się, że biblioteka jest prawidłowo zainstalowana i skonfigurowana w projektach.

Korzystanie z pomocników systemu plików

Dodaj odwołanie do Xamarin.Essentials klasy:

using Xamarin.Essentials;

Aby pobrać katalog aplikacji do przechowywania danych pamięci podręcznej. Dane pamięci podręcznej mogą być używane dla dowolnych danych, które muszą być przechowywane dłużej niż dane tymczasowe, ale nie powinny być danymi wymaganymi do prawidłowego działania, ponieważ system operacyjny określa, kiedy ten magazyn jest czyszczone.

var cacheDir = FileSystem.CacheDirectory;

Aby uzyskać katalog najwyższego poziomu aplikacji dla wszystkich plików, które nie są plikami danych użytkownika. Te pliki są kopiami zapasowymi za pomocą platformy synchronizacji systemu operacyjnego. Zobacz Szczegóły implementacji platformy poniżej.

var mainDir = FileSystem.AppDataDirectory;

Jeśli chcesz otworzyć plik, który został dołączony do pakietu aplikacji, możesz użyć OpenAppPackageFileAsync metody , aby odczytać zawartość. W poniższym przykładzie plik o nazwie mybundledfile.txt został dodany do każdej platformy. Aby uzyskać szczegółowe informacje, zobacz sekcję dotyczącą implementacji platformy.

 var fileName = "mybundledfile.txt";
 using (var stream = await FileSystem.OpenAppPackageFileAsync(fileName))
 {
    using (var reader = new StreamReader(stream))
    {
        var fileContents = await reader.ReadToEndAsync();
    }
 }

Specyfika implementacji platformy

Android

• CacheDirectory — zwraca wartość CacheDir bieżącego kontekstu.
• AppDataDirectory — zwraca wartość FilesDir bieżącego kontekstu i jest tworzona kopia zapasowa przy użyciu funkcji automatycznej kopii zapasowej rozpoczynającej się od interfejsu API 23 lub nowszego.

Dodaj dowolny plik do folderu Assets w projekcie systemu Android i oznacz akcję kompilacji jako AndroidAsset , aby używać go z OpenAppPackageFileAsync.

iOS

• CacheDirectory — zwraca katalog Library/Caches .
• AppDataDirectory — zwraca katalog Biblioteki , którego kopia zapasowa jest tworzona przez program iTunes i usługę iCloud.

Ważne

W symulatorze systemu iOS identyfikator aplikacji (który jest częścią nazwy katalogu) zmienia się w każdej kompilacji, więc musisz pobrać prawidłowy identyfikator za każdym razem, gdy skompilujesz aplikację dla symulatora.

Dodaj dowolny plik do folderu Resources w projekcie systemu iOS i oznacz akcję kompilacji jako BundledResource, aby użyć go z OpenAppPackageFileAsync.

Platforma UWP

• CacheDirectory — zwraca katalog LocalCacheFolder .
• AppDataDirectory — zwraca katalog LocalFolder , którego kopia zapasowa jest tworzona w chmurze.

Dodaj dowolny plik do katalogu głównego w projekcie platformy UWP i oznacz akcję kompilacji jako zawartość , aby używać go z OpenAppPackageFileAsync.

interfejs API

• Kod źródłowy pomocników systemu plików
• Dokumentacja interfejsu API systemu plików

Powiązany film wideo

Więcej filmów na platformie Xamarin można znaleźć w witrynach Channel 9 i YouTube.