File.OpenHandle Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la SafeFileHandle classe avec le chemin d’accès spécifié, le mode de création, l’autorisation de lecture/écriture et de partage, l’accès à d’autres SafeFileHandles peut avoir pour le même fichier, des options de fichier supplémentaires et la taille d’allocation.
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 SafeFileHandleParamètres
- path
- String
Chemin d’accès relatif ou absolu pour le fichier encapsulé par l’instance actuelle SafeFileHandle .
- mode
- FileMode
Une des valeurs d’énumération qui détermine comment ouvrir ou créer le fichier. La valeur par défaut est Open.
- access
- FileAccess
Combinaison au niveau du bit des valeurs d’énumération qui détermine la façon dont le fichier est accessible. La valeur par défaut est Read.
- share
- FileShare
Combinaison au niveau du bit des valeurs d’énumération qui détermine la façon dont le fichier sera partagé par les processus. La valeur par défaut est Read.
- options
- FileOptions
Objet qui décrit les paramètres facultatifs SafeFileHandle à utiliser.
- preallocationSize
- Int64
Taille d’allocation initiale en octets pour le fichier. Une valeur positive est effective uniquement lorsqu’un fichier normal est créé, remplacé ou remplacé. Les valeurs négatives ne sont pas autorisées. Dans d’autres cas (y compris la valeur par défaut 0), elle est ignorée.
Retours
Une instance SafeFileHandle .
Exceptions
path a la valeur null.
path est une chaîne vide ( » « ), contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides.
-ou- path fait référence à un appareil non-fichier, tel que CON:, COM1:, LPT1:, etc. dans un environnement NTFS.
path fait référence à un appareil non-fichier, tel que CON:, COM1:, LPT1:, etc. dans un environnement non NTFS.
preallocationSize est négatif.
-ou- mode, accessou share contenir une valeur non valide.
Impossible de trouver le fichier, tel que le moment modeTruncate ou Openle fichier spécifié par path n’existe pas. Le fichier doit déjà exister dans ces modes.
Une erreur d’E/S, telle que la spécification CreateNew du fichier spécifié par path déjà, s’est produite.
-ou- Le disque était plein (quand preallocationSize il était fourni et path pointait vers un fichier normal).
-ou- Le fichier était trop volumineux (quand preallocationSize il était fourni et path pointait vers un fichier normal).
L’appelant n’a pas l’autorisation requise.
Le chemin spécifié n’est pas valide, par exemple sur un lecteur non mappé.
La access demande n’est pas autorisée par le système d’exploitation pour le système d’exploitation spécifié path, par exemple quand access est Write ou ReadWrite si le fichier ou le répertoire est défini pour l’accès en lecture seule.
-ou- Encrypted est spécifié pour options, mais le chiffrement de fichiers n’est pas pris en charge sur la plateforme actuelle.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.
