File.OpenHandle Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la SafeFileHandle clase con la ruta de acceso, el modo de creación, el permiso de lectura y escritura y uso compartido especificados, el acceso a safeFileHandles puede tener en el mismo archivo, opciones de archivo adicionales y el tamaño de asignación.

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

Parámetros

path

String

Ruta de acceso relativa o absoluta para el archivo que la instancia actual SafeFileHandle encapsulará.

mode

FileMode

Uno de los valores de enumeración que determina cómo abrir o crear el archivo. El valor predeterminado es Open

access

FileAccess

Combinación bit a bit de los valores de enumeración que determina cómo se puede acceder al archivo. El valor predeterminado es Read

share

FileShare

Combinación bit a bit de los valores de enumeración que determina cómo los procesos compartirán el archivo. El valor predeterminado es Read.

options

FileOptions

Objeto que describe parámetros opcionales SafeFileHandle que se van a usar.

preallocationSize

Int64

Tamaño de asignación inicial en bytes para el archivo. Un valor positivo solo es efectivo cuando se crea, sobrescribe o reemplaza un archivo normal. No se permiten valores negativos. En otros casos (incluido el valor predeterminado 0), se omite.

Devoluciones

SafeFileHandle

Instancia de SafeFileHandle.

Excepciones

ArgumentNullException

path es null.

ArgumentException

path es una cadena vacía (""), solo contiene espacios en blanco o uno o más caracteres no válidos. -o bien- path hace referencia a un dispositivo que no es de archivo, como CON:, COM1:, LPT1:, etc. en un entorno NTFS.

NotSupportedException

path hace referencia a un dispositivo que no es de archivo, como CON:, COM1:, LPT1:, etc. en un entorno que no es NTFS.

ArgumentOutOfRangeException

preallocationSize es negativo. -o bien- mode, accesso share contienen un valor no válido.

FileNotFoundException

No se encuentra el archivo, como cuando mode es Truncate o Open, y el archivo especificado por path no existe. El archivo ya debe existir en estos modos.

IOException

Se ha producido un error de E/S, como cuando se especifica CreateNew cuando el archivo especificado por path ya existe. -o bien- El disco estaba lleno (cuando preallocationSize se proporcionó y path apuntaba a un archivo normal). -o bien- El archivo era demasiado grande (cuando preallocationSize se proporcionó y path apuntaba a un archivo normal).

SecurityException

El llamador no dispone del permiso requerido.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, por ejemplo, está en una unidad no asignada.

UnauthorizedAccessException

El sistema operativo no permite la access solicitud para el especificado path, como cuando access es Write o ReadWrite y el archivo o directorio está establecido para el acceso de solo lectura. -o bien- Encrypted se especifica para options, pero el cifrado de archivos no se admite en la plataforma actual.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.