File.OpenHandle 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.
Sınıfın SafeFileHandle yeni bir örneğini belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izniyle başlatır, diğer SafeFileHandle'ların aynı dosyaya, ek dosya seçeneklerine ve ayırma boyutuna erişmesi gerekir.
public static Microsoft.Win32.SafeHandles.SafeFileHandle OpenHandle (string path, System.IO.FileMode mode = System.IO.FileMode.Open, System.IO.FileAccess access = System.IO.FileAccess.Read, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None, long preallocationSize = 0);static member OpenHandle : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.IO.FileOptions * int64 -> Microsoft.Win32.SafeHandles.SafeFileHandlePublic Shared Function OpenHandle (path As String, Optional mode As FileMode = System.IO.FileMode.Open, Optional access As FileAccess = System.IO.FileAccess.Read, Optional share As FileShare = System.IO.FileShare.Read, Optional options As FileOptions = System.IO.FileOptions.None, Optional preallocationSize As Long = 0) As SafeFileHandleParametreler
- path
- String
Geçerli SafeFileHandle örneğin kapsülleeceği dosya için göreli veya mutlak bir yol.
- mode
- FileMode
Dosyanın nasıl açıldığını veya oluşturulacağını belirleyen numaralandırma değerlerinden biri. Varsayılan değer: Open
- access
- FileAccess
Dosyaya nasıl erişilebileceğini belirleyen numaralandırma değerlerinin bit düzeyinde birleşimi. Varsayılan değer: Read
- share
- FileShare
Dosyanın işlemler tarafından nasıl paylaşılacağını belirleyen numaralandırma değerlerinin bit düzeyinde birleşimi. Read varsayılan değerdir.
- options
- FileOptions
Kullanılacak isteğe bağlı SafeFileHandle parametreleri açıklayan bir nesne.
- preallocationSize
- Int64
Dosyanın bayt cinsinden ilk ayırma boyutu. Pozitif bir değer yalnızca normal bir dosya oluşturulurken, üzerine yazılırken veya değiştirilirken etkilidir. Negatif değerlere izin verilmez. Diğer durumlarda (varsayılan 0 değeri dahil) yoksayılır.
Döndürülenler
Bir SafeFileHandle örnek.
Özel durumlar
path, null değeridir.
path boş bir dizedir (""), yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir.
-veya- path bir NTFS ortamındaki , COM1:, LPT1:vb. gibi CON:dosya olmayan bir cihazı ifade eder.
pathNTFS olmayan bir ortamda , COM1:, LPT1:vb. gibi CON:dosya olmayan bir cihazı ifade eder.
preallocationSize negatiftir.
-veya- mode, accessveya share geçersiz bir değer içeriyor.
veya gibi bir dosya bulunamıyor modeTruncateOpenve tarafından path belirtilen dosya mevcut değil. Dosya bu modlarda zaten mevcut olmalıdır.
tarafından path belirtilen dosyanın ne zaman mevcut olduğunu belirtme CreateNew gibi bir G/Ç hatası oluştu.
-veya- Disk doluydu (sağlandığında preallocationSize ve path normal bir dosyaya işaret ettiğinde).
-veya- Dosya çok büyük (sağlandığında preallocationSize ve path normal bir dosyaya işaret ettiğinde).
Çağıranın gerekli izni yok.
Belirtilen yol, eşlenmemiş bir sürücüde olmak gibi geçersiz.
İstenenaccess, veya gibi belirtilen WritepathaccessReadWrite işletim sistemi tarafından izin verilmez ve dosya veya dizin salt okunur erişim için ayarlanır.
-or- Encrypted için optionsbelirtilir, ancak geçerli platformda dosya şifrelemesi desteklenmez.
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
