Zarządzanie plikami, folderami i bibliotekami za pomocą zestawu SDK aplikacji systemu Windows

Zestaw SDK aplikacji systemu Windows zapewnia zaawansowane funkcje zarządzania plikami dla spakowanych aplikacji. Interfejsy API można używać 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 rozpoczynających się w systemie Windows 10. Te funkcje są dostępne za pośrednictwem kombinacji zestawu SDK aplikacji systemu Windows, środowiska uruchomieniowego systemu Windows (WinRT) i interfejsów API platformy .NET udostępnianych przez zestaw SDK aplikacji systemu Windows, zestaw SDK systemu Windows i zestaw SDK platformy .NET.

Odczytywanie i zapisywanie danych przy użyciu selektorów zestawu SDK aplikacji systemu Windows

Interfejsy API selektora są dostępne w zestawie SDK aplikacji systemu Windows w wersji 1.8 lub nowszej. 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 zestawu SDK aplikacji systemu Windows, aby umożliwić użytkownikom przeglądanie i wybieranie plików lub folderów w aplikacji WinUI. API selektora plików zapewniają znane środowisko systemu Windows, które ułatwia użytkownikom nawigowanie po ich urządzeniu i lokalizacjach przechowywania w chmurze. Dowiedz się, jak umożliwić użytkownikom wybranie pliku lub folderu do otwarcia przy użyciu klas FileOpenPicker i FolderPicker .
Zapisywanie pliku za pomocą selektora zestawu SDK aplikacji systemu Windows w usłudze 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. Zestaw SDK aplikacji systemu Windows 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 zestawów Sdk aplikacji systemu Windows i WinRT

Poniżej przedstawiono kilka kluczowych różnic w porównaniu z WinRT Windows.Storage.Pickers używanymi przez aplikacje 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 pomocą klas PickFileResult i PickFolderResult. Upraszcza to interfejs API i pozwala uniknąć komplikacji z możliwościami magazynu w scenariuszach z podwyższonym poziomem uprawnień.
• Podobnie właściwość FileSavePicker.SuggestedSaveFile (która zwróciła plik StorageFile) została zastąpiona. Jego funkcjonalność jest teraz objęta dwoma 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 korzystanie z nich bez konieczności określenia parametru 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 Grupy głównej została wykluczona z nowego wyliczenia PickerLocationId , ponieważ nie jest już obsługiwana w systemie Windows 10.
• FolderPicker.FileTypeFilter został wykluczony, ponieważ nie był funkcjonalnie odpowiedni dla zaznaczenia 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.

Uzyskiwanie dostępu do danych za pomocą interfejsów API magazynu WinRT

Spakowane aplikacje mają dostęp do wszystkich interfejsów API magazynu WinRT dostępnych dla aplikacji platformy 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. Przykłady użycia interfejsów API magazynu w aplikacji WinUI można znaleźć w temacie Uzyskiwanie dostępu do plików i folderów przy użyciu zestawu SDK aplikacji Windows i interfejsów API WinRT.

Używanie interfejsów API plików platformy .NET na potrzeby dostępu do danych

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

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

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

Przykłady użycia interfejsów API platformy .NET w aplikacji WinUI można znaleźć w temacie Access files and folders with Windows App SDK and .NET APIs (Uzyskiwanie dostępu do plików i folderów przy użyciu zestawu SDK aplikacji systemu Windows i interfejsów API platformy .NET).

Dodatkowe zasoby do pracy z plikami i folderami

Jeśli tworzysz spakowane aplikacje WinUI, interfejsy API magazynu WinRT mogą być zaawansowanym 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	Uzyskaj dostęp do plików i folderów w folderze, bibliotece, urządzeniu lub lokalizacji sieciowej. 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 rozwiązania dotyczące używania różnych metod zapisywania plików klas FileIO i PathIO .
Uzyskaj właściwości pliku	Pobieranie 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 HomeGroup użytkownika, w tym zdjęcia, muzykę i filmy wideo.
Określanie dostępności plików usługi Microsoft OneDrive	Ustal, czy plik Usługi 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.
Uzyskiwanie dostępu do karty SD	Możesz przechowywać i uzyskiwać dostęp do danych innych niż niezbędne na opcjonalnej karcie mikroSD, zwłaszcza na urządzeniach przenośnych o niskich kosztach, które mają ograniczony magazyn wewnętrzny.
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 środowiska uruchomieniowego systemu Windows.

Zobacz także

Uzyskiwanie dostępu do plików i folderów za pomocą zestawu SDK aplikacji systemu Windows i interfejsów API WinRT

Uzyskiwanie dostępu do plików i folderów za pomocą zestawu SDK aplikacji systemu Windows i interfejsów API platformy .NET

System.IO