File.OpenHandle Yöntem

Tanım

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.SafeFileHandle
Public 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 SafeFileHandle

Parametreler

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.

Şunlara uygulanır