File.OpenHandle Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

File.cs

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

SafeFileHandle

Bir SafeFileHandle örnek.

Özel durumlar

ArgumentNullException

path, null değeridir.

ArgumentException

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.

NotSupportedException

pathNTFS olmayan bir ortamda , COM1:, LPT1:vb. gibi CON:dosya olmayan bir cihazı ifade eder.

ArgumentOutOfRangeException

preallocationSize negatiftir. -veya- mode, accessveya share geçersiz bir değer içeriyor.

FileNotFoundException

veya gibi bir dosya bulunamıyor modeTruncateOpenve tarafından path belirtilen dosya mevcut değil. Dosya bu modlarda zaten mevcut olmalıdır.

IOException

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).

SecurityException

Çağıranın gerekli izni yok.

DirectoryNotFoundException

Belirtilen yol, eşlenmemiş bir sürücüde olmak gibi geçersiz.

UnauthorizedAccessException

İ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.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.