File.OpenHandle Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

File.cs

Inizializza una nuova istanza della SafeFileHandle classe con il percorso, la modalità di creazione, l'autorizzazione di lettura/scrittura e condivisione, l'accesso ad altri SafeFileHandles può avere sullo stesso file, opzioni di file aggiuntive e dimensioni di allocazione.

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

Parametri

path

String

Percorso relativo o assoluto per il file incapsulato dall'istanza corrente SafeFileHandle .

mode

FileMode

Uno dei valori di enumerazione che determina come aprire o creare il file. Il valore predefinito è Open

access

FileAccess

Combinazione bit per bit dei valori di enumerazione che determina la modalità di accesso al file. Il valore predefinito è Read

share

FileShare

Combinazione bit per bit dei valori di enumerazione, che determina come il file verrà condiviso dai processi. Il valore predefinito è Read.

options

FileOptions

Oggetto che descrive i parametri facoltativi SafeFileHandle da utilizzare.

preallocationSize

Int64

Dimensione di allocazione iniziale in byte per il file. Un valore positivo è valido solo quando viene creato, sovrascritto o sostituito un file normale. I valori negativi non sono consentiti. In altri casi (incluso il valore predefinito 0), viene ignorato.

Restituisce

SafeFileHandle

Istanza di SafeFileHandle.

Eccezioni

ArgumentNullException

path è null.

ArgumentException

path è una stringa vuota (""), contiene solo spazi vuoti oppure contiene uno o più caratteri non validi. -oppure- path fa riferimento a un dispositivo non file, ad esempio CON:, COM1:, LPT1:e così via in un ambiente NTFS.

NotSupportedException

path fa riferimento a un dispositivo non file, ad esempio CON:, COM1:, LPT1:e così via in un ambiente non NTFS.

ArgumentOutOfRangeException

preallocationSize è negativo. -oppure- mode, accesso share contengono un valore non valido.

FileNotFoundException

Il file non è stato trovato, ad esempio se mode è Truncate o Open e il file specificato da path non esiste. È necessario che il file sia già disponibile in queste modalità.

IOException

Si è verificato un errore di I/O, ad esempio quando si specifica CreateNew e il file specificato da path è già presente. -oppure- Il disco era pieno (quando preallocationSize è stato fornito e path puntava a un file normale). -oppure- Il file era troppo grande (quando preallocationSize è stato fornito e path puntava a un file normale).

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

UnauthorizedAccessException

L'oggetto access richiesto non è consentito dal sistema operativo per l'oggetto path specificato, ad esempio quando access è Write o ReadWrite e la directory o il file è impostato per l'accesso in sola lettura. -oppure- Encrypted è specificato per options, ma la crittografia dei file non è supportata nella piattaforma corrente.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.