File.OpenHandle Método

Definición

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

Instancia de SafeFileHandle.

Excepciones

path es null.

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.

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

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

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.

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).

El llamador no dispone del permiso requerido.

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

El sistema operativo no permite el objeto access solicitado para el objeto path especificado, 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.

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

Se aplica a