File.OpenHandle Méthode

Définition

Initialise une nouvelle instance de la classe avec le SafeFileHandle 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 au 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.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

Paramètres

path
String

Chemin d’accès relatif ou absolu pour le fichier que le instance actuel SafeFileHandle encapsulera.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier. La valeur par défaut est Open.

access
FileAccess

Combinaison de bits 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 de bits des valeurs d’énumération qui détermine comment 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 n’est effective que 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

Instance de SafeFileHandle.

Exceptions

path a la valeur null.

path est une chaîne vide (""), contient seulement 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 périphérique non-fichier, tel que CON:, COM1:, LPT1:, etc. dans un environnement non NTFS.

preallocationSize est un nombre négatif. -ou- mode, accessou share contiennent une valeur non valide.

Le fichier est introuvable, comme quand mode a pour valeur Truncate ou Open, et que le fichier spécifié par path n’existe pas. Le fichier doit déjà exister dans ces modes.

Une erreur d’E/S s’est produite, par exemple la spécification de CreateNew quand le fichier spécifié par path existe déjà. -ou- Le disque était plein (quand preallocationSize était fourni et path pointait vers un fichier normal). - ou - Le fichier était trop volumineux (quand preallocationSize a été 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 si l’emplacement est un lecteur non mappé.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule. -ou- Encrypted est spécifié pour options, mais le chiffrement de fichier n’est pas pris en charge sur la plateforme actuelle.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

S’applique à