Windows Uygulama SDK'sı ile dosyaları, klasörleri ve kitaplıkları yönetme

Windows Uygulama SDK'sı, paketlenmiş uygulamalar için güçlü dosya yönetimi özellikleri sağlar. Windows.Storage, Windows.Storage.Streams ve Microsoft.Windows.Storage.Pickers ad alanlarına ait API'leri kullanarak dosyalardaki çeşitli veri biçimlerini verimli bir şekilde okuyabilir ve yazabilir, ayrıca dosya ve klasörleri yönetebilirsiniz.

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 Uygulama SDK'sı, Windows Çalışma Zamanı (WinRT) ve Windows Uygulama SDK'sı, Windows SDK'sı ve .NET SDK'sı tarafından sağlanan .NET API'lerinin birleşimiyle kullanılabilir.

Verileri okumak ve yazmak için Windows Uygulama SDK seçicilerini kullanma

Windows Uygulama SDK'sı sürüm 1.8 ve sonraki sürümlerde kullanılabilir seçici API'leri vardır. 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 Uygulama SDK'sı dosya ve klasör seçicilerini kullanın. Seçici API'leri, kullanıcıların cihazlarında ve bulut depolama 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'de Windows Uygulama SDK seçicisi ile dosya kaydetme	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 Uygulama SDK'sı, 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şturmak için FileSavePicker sınıfını sağlar.

WinRT ve Windows Uygulama SDK seçicileri arasındaki önemli farklar

UWP uygulamaları tarafından kullanılan WinRT Windows.Storage.Pickers'dan bazı önemli farklar şunlardır:

• StorageFile ve StorageFolder nesnelerini döndüren mevcut Windows.Storage.Pickers API'sinin aksine, 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 depolama özellikleriyle ilgili komplikasyonları önler.
• Benzer şekilde, FileSavePicker.SuggestedSaveFile özelliği ( StorageFile döndüren) değiştirilmiştir. İşlevselliği artık iki dize özelliği tarafından 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 izin verir. 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.
• Ev Grubu konumu, Windows 10'dan başlayarak artık desteklenmediğinden yeni PickerLocationId sabit listesinin dışında tutuldu.
• Klasör seçimi için işlevsel olarak uygun olmadığından FolderPicker.FileTypeFilter 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'leri ile verilere erişme

Paketlenmiş uygulamalar, UWP uygulamalarında kullanılabilen tüm WinRT depolama API'lerine erişebilir. Mevcut bir UWP uygulamasını geçirirken veya yeni bir uygulama oluştururken veri okumak ve yazmak için bu API'leri kullanabilirsiniz. WinUI uygulamasında depolama API'lerini kullanma örnekleri için bkz. Windows Uygulama SDK'sı ve WinRT API'leri ile dosya ve klasörlere erişme.

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 projesi oluşturulduğunda, Package.appxmanifest dosyasında aşağıdaki ayar bulunur:

<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 erişim 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 sistemine diğer .NET masaüstü uygulamalarıyla aynı erişime sahiptir.

WinUI uygulamasında .NET API'lerini kullanma örnekleri için bkz. Windows Uygulama SDK'sı ve .NET API'leri ile dosya ve klasörlere erişme.

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

Paketlenmiş WinUI uygulamaları geliştiriyorsanız, WinRT depolama 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 bir 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	Resimler, müzikler ve videolar dahil olmak üzere kullanıcının Ev Grubu klasöründe depolanan içeriğe erişin.
Microsoft OneDrive dosyalarının kullanılabilirliğini belirleme	StorageFile.IsAvailable özelliğini kullanarak 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 karta erişme	Özellikle sınırlı dahili depolama alanı olan düşük maliyetli mobil cihazlarda isteğe bağlı bir microSD kartta temel olmayan verileri depolayabilir ve bu verilere erişebilirsiniz.
Dosya özelliklerine hızlı erişim	Windows Çalışma Zamanı 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

Windows Uygulama SDK'sı ve WinRT API'leri ile dosya ve klasörlere erişme

Windows Uygulama SDK'sı ve .NET API'leri ile dosya ve klasörlere erişme

System.IO