Windows App SDK ile dosyaları, klasörleri ve kitaplıkları yönetme

Windows App SDK, paketlenmiş uygulamalar için güçlü dosya yönetimi özellikleri sağlar. Windows.Storage, Windows.Storage.Streams ve Microsoft.Windows.Storage.Pickers ad alanlarındaki API'leri, dosyalardaki çeşitli veri biçimlerini verimli bir şekilde okumak, yazmak ve dosya ile klasörleri yönetmek için kullanabilirsiniz.

Windows 10'dan başlayarak Windows masaüstü uygulamaları için dosyalar, klasörler, kitaplıklar ve ayarlarla ilgili çok çeşitli API'ler vardır. Bu özellikler Windows App SDK, Windows SDK ve .NET SDK tarafından sağlanan Windows App SDK, Windows Runtime (WinRT) ve .NET API'lerinin birleşimiyle kullanılabilir.

Verileri okumak ve yazmak için Windows App SDK seçicileri kullanma

Windows App SDK 1.8 ve sonraki sürümlerinde seçici API'ler mevcuttur. Aşağıdaki konular, kullanıcıların uygulamanızdaki dosya ve klasörleri açmasına ve kaydetmesine izin vermek için seçici API'lerini kullanma hakkında bilgi sağlar:

Konu	Description
WinUI'de seçicilerle dosya ve klasörleri açma	Kullanıcıların WinUI uygulamanızdaki dosyalara veya klasörlere göz atmasına ve klasör seçmesine izin vermek için Windows App SDK dosya ve klasör seçicileri kullanın. Seçici API'leri, kullanıcıların cihazlarında ve bulut storage konumlarında gezinmelerine yardımcı olan tanıdık bir Windows deneyimi sağlar. kullanıcıların FileOpenPicker ve FolderPicker sınıflarını kullanarak açmak üzere bir dosya veya klasör seçmesine nasıl izin vereceğinizi öğrenin.
WinUI	WinUI uygulamaları ve diğer Windows istemci uygulamaları oluştururken kullanıcıların genellikle belge, resim veya diğer içerik gibi dosyaları cihazlarında belirli konumlara kaydetmesi gerekir. Windows App SDK FileSavePicker sınıfını sağlayarak kullanıcıların dosyaların nereye kaydedileceğini ve ne ad verileceğini seçmesine olanak tanıyan tutarlı, kullanıcı dostu bir arabirim oluşturur.

WinRT ile Windows App SDK seçiciler arasındaki önemli farklar

İşte UWP uygulamaları tarafından kullanılan WinRT Windows.Storage.Pickers'dan bazı temel farklar:

• Mevcut Windows.Storage.Pickers API'si, StorageFile ve StorageFolder nesnelerini döndürürken, bu yeni API, PickFileResult ve PickFolderResult sınıfları aracılığıyla dize tabanlı yollar döndürür. Bu, API'yi basitleştirir ve yükseltilmiş senaryolarda storage özellikleriyle ilgili komplikasyonları önler.
• Benzer şekilde, FileSavePicker.SuggestedSaveFile özelliği (StorageFile) değiştirilmiştir. İşlevselliği artık iki dize özelliğiyle ele alınmıştır: SuggestedFolder ve SuggestedFileName. Bunlar, kaydet iletişim kutusu için klasör ve dosya adını önermenizi sağlar.
• Tüm yeni seçiciler masaüstü uygulamalar için özel olarak tasarlanmıştır ve WindowId özelliği kullanılarak seçiciyi konak penceresine bağlar, WinRT.Interop.InitializeWithWindow.Initialize modelinin yerini alır.
• Yeni seçiciler, geliştiricilerin FileTypeFilter veya FileTypeChoices belirtilmesine gerek kalmadan bunları kullanmasına olanak sağlar. UWP seçicileri bu özellikler ayarlanmadığında özel durumlar oluştururken, geliştiriciler bu özellikleri açıkça yapılandırmadığında yeni seçiciler varsayılan olarak tüm dosyaları gösterir.
• HomeGroup konumu, Windows 10'dan itibaren artık desteklenmediği için yeni PickerLocationId enum'undan çıkarılmıştır.
• FolderPicker.FileTypeFilter klasör seçimi için işlevsel olarak uygun olmadığından dışlandı.
• Zaten kullanım dışı veya "Kullanmayın" olarak işaretlenmiş yöntemleri ve özellikleri dışlama. Örneğin PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync vb.
• Yeni API'ler şu anda her kullanıcının kendi etkileşimli oturumuna sahip olduğu ve her oturumun cihazdaki diğer oturumlardan tamamen bağımsız olduğu masaüstü senaryoları için tasarlandığından, çok kullanıcılı mod için yöntemler ve özellikler hariç tutulur. Bu, Xbox veya diğer çok kullanıcılı cihazların aksinedir.

WinRT depolama API'leriyle verilere erişin

Paketlenmiş uygulamalar, UWP uygulamalarında kullanılabilen tüm WinRT storage API'lerine access sahiptir. Mevcut bir UWP uygulamasını geçirirken veya yeni bir uygulama oluştururken veri okumak ve yazmak için bu API'leri kullanabilirsiniz. WinUI 3 uygulamasında depolama API'lerini kullanma örnekleri için, Windows App SDK ve WinRT API'lerini kullanarak dosya ve klasörlere erişim kısmına bakın.

Veri erişimi için .NET dosya API'lerini kullanma

WinRT API'lerine ek olarak, paketlenmiş masaüstü uygulamaları verileri okumak ve yazmak için System.IO ad alanındaki .NET API'lerini kullanabilir. Yeni bir WinUI project oluşturulduğunda, Package.appxmanifest dosyası aşağıdaki ayarı içerir:

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

Bu kısıtlı özelliği bildirmek dosya sistemine, kayıt defterine ve diğer kısıtlanmış özelliklere tam access sağlar. Daha fazla bilgi için bkz . Kısıtlı yetenek bildirimleri. Başka bir deyişle uygulama, .NET dosya API'lerini kullanırken dosya sisteminde diğer .NET masaüstü uygulamalarıyla aynı access sahiptir.

WinUI uygulamasında .NET API'lerini kullanma örnekleri için bkz. Windows App SDK ve .NET API içeren Access dosyaları ve klasörleri.

Dosya ve klasörlerle çalışmak için ek kaynaklar

Paketlenmiş WinUI uygulamaları geliştiriyorsanız, WinRT storage API'leri verileri okumak ve yazmak için güçlü bir araç olabilir. Aşağıdaki UWP konuları, uygulamalarında bu API'lerden yararlanmak isteyen geliştiriciler için zengin bilgiler sağlar.

Konu	Description
Dosya ve klasörleri listeleme ve sorgulama	Klasör, kitaplık, cihaz veya ağ konumundaki dosya ve klasörlere erişin. Dosya ve klasör sorguları oluşturarak bir konumdaki dosya ve klasörleri de sorgulayabilirsiniz.
Dosya oluşturma, yazma ve okuma	StorageFile nesnesi kullanarak dosyayı okuyun ve yazın.
Dosyalara yazmak için en iyi yöntemler	FileIO ve PathIO sınıflarının çeşitli dosya yazma yöntemlerini kullanmaya yönelik en iyi yöntemleri öğrenin.
Dosya özelliklerini alma	StorageFile nesnesiyle temsil edilen bir dosya için en üst düzey, temel ve genişletilmiş özellikleri alın.
Ev Grubu içeriğine erişme	Kullanıcının Ev Grubu klasöründe depolanan içeriğe, resimler, müzikler ve videolar dahil olmak üzere erişin.
Microsoft OneDrive dosyalarının kullanılabilirliğini belirleme	StorageFile.IsAvailable özelliği kullanılarak bir Microsoft OneDrive dosyasının kullanılabilir olup olmadığını belirleyin.
Müzik, Resimler ve Videolar kitaplıklarındaki dosya ve klasörler	Mevcut müzik, resim veya video klasörlerini ilgili kitaplıklara ekleyin. Ayrıca kitaplıklardan klasörleri kaldırabilir, kitaplıktaki klasörlerin listesini alabilir ve depolanan fotoğrafları, müzikleri ve videoları keşfedebilirsiniz.
Son kullanılan dosyaları ve klasörleri izleme	Kullanıcınızın sık eriştiği dosyaları uygulamanızın en son kullanılan listesine (MRU) ekleyerek izleyin. Platform, öğeleri en son ne zaman erişildiğine göre sıralayarak ve listenin 25 öğe sınırına ulaşıldığında en eski öğeyi kaldırarak MRU'ları sizin için yönetir. Tüm uygulamaların kendi MRU'ları vardır.
Arka planda dosya sistemi değişikliklerini izleme	Uygulama çalışmadığında bile dosya sisteminde yapılan değişiklikleri izleyin.
SD kartına erişim	Temel olmayan verileri, özellikle sınırlı dahili depolamaya sahip düşük maliyetli mobil cihazlarda, isteğe bağlı bir microSD kartta depolayabilir ve erişim sağlayabilirsiniz.
Dosya özelliklerine hızlı erişim	Windows Runtime API'leri aracılığıyla kullanmak üzere bir kitaplıktan dosyaların ve özelliklerinin listesini verimli bir şekilde toplayın.

Ayrıca bakınız

Dosyalara ve klasörlere Windows App SDK ve WinRT API'leri ile erişin

Windows App SDK ve .NET API'lerini kullanarak dosya ve klasörlere erişin

System.IO