WindowsRuntimeStorageExtensions.CreateSafeFileHandle Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Genişletilmiş IStorage örneği için güvenli bir dosya tanıtıcısına başvuru oluşturur ve döndürür.
Aşırı Yüklemeler
CreateSafeFileHandle(IStorageFolder, String, FileMode) |
Geçerli depolama klasörü örneğindeki bir dosya için güvenli bir dosya tanıtıcısı oluşturur. |
CreateSafeFileHandle(IStorageFile, FileAccess, FileShare, FileOptions) |
Geçerli depolama dosyası örneği için güvenli bir dosya tanıtıcısı oluşturur. |
CreateSafeFileHandle(IStorageFolder, String, FileMode, FileAccess, FileShare, FileOptions) |
Geçerli depolama klasörü örneğindeki bir dosya için güvenli bir dosya tanıtıcısı oluşturur. |
Açıklamalar
Windows 10 Yıldönümü Güncelleştirmesi ile ve'ye IStorageFolderIStorageFile standart bir Win32 dosya tanıtıcısı oluşturmaya olanak sağlayan yeni arabirimler eklendi: IStorageFolderHandleAccess
ve IStorageItemHandleAccess
. CreateSafeFileHandle
Uzantı yöntemleri grubu, bu arabirimlerin yöntemlerinden yararlanıyorCreate
.
API'nin temel avantajı aracılı SafeFileHandle
bir öğesine erişimdir. Bir çevresinde IStorageItem veya IStorageFolderbir AppContainer'da çalışırken oluşturmak FileStream istiyorsanız bu kritik öneme sahiptir. AppContainer'da çalışırken uygulamanın dosya erişim hakları çok sınırlıdır. Resim ve belge klasörleri gibi öğeler, uygulama işleminin çoğu dosya için haklara sahip olmadığından yerel dosya tanıtıcısının aracılığıyla RuntimeBroker.exe
proksied olmasını gerektirir. Bu API, proksied tanıtıcısını alır. Kullanıcı veri klasörlerine erişiyorsanız veya bir dosya seçici kullanıyorsanız, bu API her zaman oluşturmak FileStreamiçin kullanılmalıdır. Yol kullanmak genellikle bu durumlarda yol oluşturur AccessViolationException .
CreateSafeFileHandle(IStorageFolder, String, FileMode)
Önemli
Bu API, CLS uyumlu değildir.
Geçerli depolama klasörü örneğindeki bir dosya için güvenli bir dosya tanıtıcısı oluşturur.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Win32::SafeHandles::SafeFileHandle ^ CreateSafeFileHandle(Windows::Storage::IStorageFolder ^ rootDirectory, System::String ^ relativePath, System::IO::FileMode mode);
[System.CLSCompliant(false)]
public static Microsoft.Win32.SafeHandles.SafeFileHandle CreateSafeFileHandle (this Windows.Storage.IStorageFolder rootDirectory, string relativePath, System.IO.FileMode mode);
[<System.CLSCompliant(false)>]
static member CreateSafeFileHandle : Windows.Storage.IStorageFolder * string * System.IO.FileMode -> Microsoft.Win32.SafeHandles.SafeFileHandle
<Extension()>
Public Function CreateSafeFileHandle (rootDirectory As IStorageFolder, relativePath As String, mode As FileMode) As SafeFileHandle
Parametreler
- rootDirectory
- IStorageFolder
Geçerli depolama klasörü örneği.
- relativePath
- String
Tanıtıcı almak istediğiniz dosyanın adı.
- mode
- FileMode
İşletim sisteminin dosyayı açması gereken mod.
Döndürülenler
İşlem başarılı olursa güvenli dosya tanıtıcısı örneği; null
öğesinin rootDirectory
bir IStorageFolderHandleAccess'e dönüştürülmesi döndürür null
.
- Öznitelikler
Özel durumlar
Açıklamalar
Bu yöntem çağrılırken, belirtilen mod ise FileMode.Appenddosya erişim izniyle FileAccess.Read açılır. Diğer modlar için dosya erişim izniyle FileAccess.ReadWrite açılır.
Ayrıca, bu yöntem dosyayı akış paylaşım erişimiyle FileShare.Read ve gelişmiş dosya oluşturma seçenekleriyle FileOptions.None açar.
Şunlara uygulanır
CreateSafeFileHandle(IStorageFile, FileAccess, FileShare, FileOptions)
Önemli
Bu API, CLS uyumlu değildir.
Geçerli depolama dosyası örneği için güvenli bir dosya tanıtıcısı oluşturur.
[System.CLSCompliant(false)]
public static Microsoft.Win32.SafeHandles.SafeFileHandle CreateSafeFileHandle (this Windows.Storage.IStorageFile windowsRuntimeFile, System.IO.FileAccess access = System.IO.FileAccess.ReadWrite, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None);
[<System.CLSCompliant(false)>]
static member CreateSafeFileHandle : Windows.Storage.IStorageFile * System.IO.FileAccess * System.IO.FileShare * System.IO.FileOptions -> Microsoft.Win32.SafeHandles.SafeFileHandle
<Extension()>
Public Function CreateSafeFileHandle (windowsRuntimeFile As IStorageFile, Optional access As FileAccess = System.IO.FileAccess.ReadWrite, Optional share As FileShare = System.IO.FileShare.Read, Optional options As FileOptions = System.IO.FileOptions.None) As SafeFileHandle
Parametreler
- windowsRuntimeFile
- IStorageFile
Depolama dosyası örneği.
- access
- FileAccess
Dosyayı açarken kullanılması gereken erişim türü. ReadWrite varsayılan değerdir.
- share
- FileShare
Diğer FileStream nesnelere erişen akış paylaşımının türü aynı dosyaya sahip olabilir. Read varsayılan değerdir.
- options
- FileOptions
Nesneyi oluşturmak FileStream için gelişmiş seçenekler. None varsayılan değerdir.
Döndürülenler
İşlem başarılı olursa güvenli dosya tanıtıcısı örneği; null
öğesinin windowsRuntimeFile
bir IStorageItemHandleAccess'e dönüştürülmesi döndürür null
.
- Öznitelikler
Özel durumlar
windowsRuntimeFile
, null
değeridir.
Şunlara uygulanır
CreateSafeFileHandle(IStorageFolder, String, FileMode, FileAccess, FileShare, FileOptions)
Önemli
Bu API, CLS uyumlu değildir.
Geçerli depolama klasörü örneğindeki bir dosya için güvenli bir dosya tanıtıcısı oluşturur.
[System.CLSCompliant(false)]
public static Microsoft.Win32.SafeHandles.SafeFileHandle CreateSafeFileHandle (this Windows.Storage.IStorageFolder rootDirectory, string relativePath, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None);
[<System.CLSCompliant(false)>]
static member CreateSafeFileHandle : Windows.Storage.IStorageFolder * string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.IO.FileOptions -> Microsoft.Win32.SafeHandles.SafeFileHandle
<Extension()>
Public Function CreateSafeFileHandle (rootDirectory As IStorageFolder, relativePath As String, mode As FileMode, access As FileAccess, Optional share As FileShare = System.IO.FileShare.Read, Optional options As FileOptions = System.IO.FileOptions.None) As SafeFileHandle
Parametreler
- rootDirectory
- IStorageFolder
Geçerli depolama klasörü örneği.
- relativePath
- String
Tanıtıcı almak istediğiniz dosyanın adı.
- mode
- FileMode
İşletim sisteminin dosyayı açması gereken mod.
- access
- FileAccess
Dosyayı açarken kullanılması gereken erişim türü.
- share
- FileShare
Diğer FileStream nesnelere erişen akış paylaşımının türü aynı dosyaya sahip olabilir. Read varsayılan değerdir.
- options
- FileOptions
Nesneyi oluşturmak FileStream için gelişmiş seçenekler. None varsayılan değerdir.
Döndürülenler
İşlem başarılı olursa güvenli dosya tanıtıcısı örneği; null
öğesinin rootDirectory
bir IStorageFolderHandleAccess'e dönüştürülmesi döndürür null
.
- Öznitelikler
Özel durumlar
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin