File.OpenHandle Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.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 SafeFileHandleParametri
- 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.
