Zarządzanie plikami, folderami i bibliotekami za pomocą Windows App SDK

Windows App SDK zapewnia zaawansowane możliwości zarządzania plikami dla spakowanych aplikacji. Można używać interfejsów API z przestrzeni nazw Windows.Storage, Windows.Storage.Streams i Microsoft.Windows.Storage.Pickers, aby efektywnie odczytywać i zapisywać różne formaty danych w plikach, a także zarządzać plikami i folderami.

Istnieje wiele różnych interfejsów API związanych z plikami, folderami, bibliotekami i ustawieniami aplikacji klasycznych systemu Windows, począwszy od Windows 10. Te funkcje są dostępne za pośrednictwem kombinacji interfejsów API Windows App SDK, Windows Runtime (WinRT) i interfejsów API .NET udostępnianych przez zestaw Windows App SDKWindows SDK oraz zestaw .NET SDK.

Używanie selektorów Windows App SDK do odczytywania i zapisywania danych

API selektora są dostępne w Windows App SDK w wersji 1.8 i nowszych. Poniższe tematy zawierają informacje o korzystaniu z interfejsów API selektora, aby umożliwić użytkownikom otwieranie i zapisywanie plików i folderów w aplikacji:

Temat	Description
Otwieranie plików i folderów przy użyciu selektorów w usłudze WinUI	Użyj selektorów plików i folderów Windows App SDK, aby umożliwić użytkownikom przeglądanie i wybieranie plików lub folderów w aplikacji WinUI. Interfejsy API wyboru zapewniają znane środowisko systemu Windows, które ułatwia użytkownikom nawigowanie po lokalizacjach przechowywania na urządzeniach i w chmurze. Dowiedz się, jak zezwolić użytkownikom na otwieranie pliku lub folderu przy użyciu klas FileOpenPicker i FolderPicker.
Zapisz plik za pomocą selektora Windows App SDK w WinUI	Podczas kompilowania aplikacji WinUI i innych aplikacji klienckich systemu Windows użytkownicy często muszą zapisywać pliki, takie jak dokumenty, obrazy lub inną zawartość do określonych lokalizacji na urządzeniu. Windows App SDK udostępnia klasę FileSavePicker w celu utworzenia spójnego, przyjaznego dla użytkownika interfejsu, który umożliwia użytkownikom wybór miejsca zapisywania plików i nazw.

Kluczowe różnice między selektorami WinRT i Windows App SDK

Poniżej przedstawiono kilka kluczowych różnic od systemu WinRT Windows.Storage.Pickers używanego przez aplikacje platformy UWP:

• W przeciwieństwie do istniejącego interfejsu API Windows.Storage.Pickers, który zwraca obiekty StorageFile i StorageFolder, ten nowy interfejs API zwraca ścieżki oparte na ciągach za pośrednictwem klas PickFileResult i PickFolderResult. Upraszcza to interfejs API i pozwala uniknąć komplikacji dotyczących możliwości przechowywania w scenariuszach o podwyższonych uprawnieniach.
• Podobnie, właściwość FileSavePicker.SuggestedSaveFile (która zwracała StorageFile) została zastąpiona. Jego funkcjonalność jest teraz objęta dwiema właściwościami ciągu: SuggestedFolder i SuggestedFileName. Umożliwiają one sugerowanie folderu i nazwy pliku dla okna dialogowego zapisywania.
• Wszystkie nowe selektory są przeznaczone specjalnie dla aplikacji desktopowych i używają właściwości WindowId, aby powiązać selektor z jego oknem hosta, zastępując wzorzec WinRT.Interop.InitializeWithWindow.Initialize.
• Nowe selektory umożliwiają deweloperom ich użycie bez konieczności określania FileTypeFilter lub FileTypeChoices. Podczas gdy selektory UWP rzucają wyjątki, gdy te właściwości nie są ustawione, nowe selektory domyślnie pokazują wszystkie pliki, gdy deweloperzy nie ustawią jawnie tych właściwości.
• Lokalizacja HomeGroup została wykluczona z nowego typu wyliczeniowego PickerLocationId, ponieważ nie jest już obsługiwana, począwszy od Windows 10.
• FolderPicker.FileTypeFilter został wykluczony, ponieważ nie był funkcjonalny odpowiedni do wyboru folderu.
• Wykluczanie metod i właściwości, które są już oznaczone jako przestarzałe lub "Nie używaj". np. PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync itp.
• Wykluczanie metod i właściwości trybu wielu użytkowników, ponieważ nowe interfejsy API są obecnie przeznaczone dla scenariuszy klasycznych, w których każdy użytkownik ma własną sesję interaktywną, a każda sesja jest całkowicie niezależna od innych sesji na urządzeniu. Jest to w przeciwieństwie do konsoli Xbox lub innych urządzeń z wieloma użytkownikami.

Uzyskaj dostęp do danych za pomocą interfejsów API przechowywania WinRT

Spakowane aplikacje mają dostęp do wszystkich interfejsów API magazynowania WinRT dostępnych dla aplikacji UWP. Niezależnie od tego, czy migrujesz istniejącą aplikację platformy UWP, czy tworzysz nową aplikację, możesz użyć tych interfejsów API do odczytywania i zapisywania danych. Aby zapoznać się z przykładami wykorzystania interfejsów API przechowywania w aplikacji WinUI 3, zobacz sekcję Uzyskiwanie dostępu do plików i folderów za pomocą interfejsów API Windows App SDK i WinRT.

Użyj interfejsów API plików .NET do dostępu do danych

Oprócz interfejsów API WinRT spakowane aplikacje desktopowe mogą używać interfejsów API .NET w System.IO do odczytywania i zapisywania danych. Po utworzeniu nowego projektu WinUI plik jego Package.appxmanifest zawiera następujące ustawienie:

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

Deklarowanie tej funkcji z ograniczeniami daje pełny dostęp do systemu plików, rejestru i innych ograniczonych funkcji. Aby uzyskać więcej informacji, zobacz Deklaracje możliwości z ograniczeniami. Innymi słowy, aplikacja ma ten sam dostęp do systemu plików, co każda inna aplikacja na komputer stacjonarny .NET, podczas korzystania z API plików .NET.

Aby zapoznać się z przykładami używania interfejsów API .NET w aplikacji WinUI, zobacz Uzyskuj dostęp do plików i folderów za pomocą interfejsów API Windows App SDK i .NET.

Dodatkowe zasoby do pracy z plikami i folderami

Jeśli tworzysz spakowane aplikacje WinUI, interfejsy API przechowywania WinRT mogą być potężnym narzędziem do odczytywania i zapisywania danych. Poniższe tematy platformy UWP zawierają wiele informacji dla deweloperów, którzy chcą korzystać z tych interfejsów API w swoich aplikacjach.

Temat	Description
Wyliczanie i wykonywanie zapytań dotyczących plików i folderów	Dostęp do plików i folderów w folderze, bibliotece, urządzeniu lub miejscu w sieci. Możesz również wykonywać zapytania dotyczące plików i folderów w lokalizacji, tworząc zapytania dotyczące plików i folderów.
Tworzenie, zapisywanie i odczytywanie pliku	Odczytywanie i zapisywanie pliku przy użyciu obiektu StorageFile.
Najlepsze rozwiązania dotyczące zapisywania w plikach	Poznaj najlepsze praktyki w zakresie używania różnych metod zapisywania plików klas FileIO i PathIO.
Uzyskaj właściwości pliku	Pobierz właściwości — najwyższego poziomu, podstawowego i rozszerzonego — dla pliku reprezentowanego przez obiekt StorageFile.
Uzyskiwanie dostępu do zawartości grupy głównej	Uzyskaj dostęp do zawartości przechowywanej w folderze Grupy domowej użytkownika, takie jak zdjęcia, muzyka i filmy wideo.
Określanie dostępności plików Microsoft OneDrive	Ustal, czy plik Microsoft OneDrive jest dostępny przy użyciu właściwości StorageFile.IsAvailable.
Pliki i foldery w bibliotekach Muzyka, Obrazy i Wideo	Dodaj istniejące foldery muzyki, obrazów lub wideo do odpowiednich bibliotek. Można również usuwać foldery z bibliotek, pobierać listę folderów w bibliotece oraz odnajdywać przechowywane zdjęcia, muzykę i filmy wideo.
Śledzenie ostatnio używanych plików i folderów	Śledź pliki, do których użytkownik uzyskuje dostęp często, dodając je do ostatnio używanej listy aplikacji (MRU). Platforma zarządza elementami MRU, sortując elementy na podstawie czasu ostatniego uzyskania dostępu i usuwając najstarszy element po osiągnięciu limitu 25 elementów listy. Wszystkie aplikacje mają własne listy MRU.
Śledzenie zmian w systemie plików w tle	Śledź zmiany w systemie plików, nawet jeśli aplikacja nie jest uruchomiona.
Uzyskaj dostęp do karty SD	Możesz przechowywać i uzyskiwać dostęp do nieistotnych danych na opcjonalnej karcie microSD, szczególnie na tanich urządzeniach przenośnych, które mają ograniczoną pamięć wewnętrzną.
Szybki dostęp do właściwości pliku	Efektywnie zbieraj listę plików i ich właściwości z biblioteki do użycia za pośrednictwem interfejsów API Windows Runtime.

Zobacz także

Uzyskuj dostęp do plików i folderów za pomocą interfejsów API Windows App SDK i WinRT

Uzyskaj dostęp do plików i folderów za pomocą interfejsów API Windows App SDK i .NET

System.IO