File.OpenHandle Metodo

Definizione

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

Istanza di SafeFileHandle.

Eccezioni

path è null.

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.

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

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

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

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

Il chiamante non dispone dell'autorizzazione richiesta.

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

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.

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

Si applica a