File.OpenHandle Méthode

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

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, le mode de création, l’autorisation de lecture/écriture et de partage spécifiés, l’accès que d’autres SafeFileHandles peuvent avoir au même fichier, des options de fichiers 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 l' SafeFileHandle instance en cours doit encapsuler.

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 d’opérations de bits des valeurs d’énumération qui détermine comment 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, du fichier. Une valeur positive est effective uniquement lorsqu’un fichier normal est en cours de création, de remplacement ou de remplacement. Les valeurs négatives ne sont pas autorisées. Dans d’autres cas (y compris la valeur 0 par défaut), elle est ignorée.

Retours

SafeFileHandle

Instance de SafeFileHandle.

Exceptions

ArgumentNullException

path est null.

ArgumentException

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 périphérique qui n’est pas un fichier, tel que con :, COM1 :, LPT1 :, etc. dans un environnement NTFS.

NotSupportedException

path fait référence à un périphérique qui n’est pas un fichier, tel que con :, COM1 :, LPT1 :, etc. dans un environnement non-NTFS.

ArgumentOutOfRangeException

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

FileNotFoundException

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.

IOException

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 est plein (lorsque preallocationSize a été fourni et path pointe vers un fichier normal). -ou-le fichier est trop volumineux (lorsque preallocationSize a été fourni et path pointe vers un fichier normal).

SecurityException

L'appelant n'a pas l'autorisation requise.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.

UnauthorizedAccessException

Le access demandé n’est pas autorisé par le système d’exploitation pour le spécifié path , par exemple quand access a la Write ReadWrite valeur ou 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 des fichiers n’est pas pris en charge sur la plateforme actuelle.

PathTooLongException

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

S’applique à